DIF_REGISTER_COINSTALLERS

Artikel
06/15/2023

Eine DIF_REGISTER_COINSTALLERS-Anforderung ermöglicht es einem Installationsprogramm, an der Registrierung von Geräte-Co-Installern teilzunehmen.

Sendebedingungen

Bevor Sie die Geräteinstallation abschließen.

Wer verarbeitet

Klassen-Co-Installer	Kann verarbeiten
Geräte-Co-Installer	Behandelt nicht
Klasseninstallationsprogramm	Kann verarbeiten

Installationsprogrammeingabe

DeviceInfoSet
Stellt ein Handle für den Geräteinformationssatz bereit, der das Gerät enthält, für das Co-Installer registriert werden sollen.

DeviceInfoData
Stellt einen Zeiger auf eine SP_DEVINFO_DATA-Struktur bereit, die das Gerät im Geräteinformationssatz identifiziert.

Geräteinstallationsparameter
DeviceInfoData sind Geräteinstallationsparameter (SP_DEVINSTALL_PARAMS) zugeordnet.

Klasseninstallationsparameter
Keine

Installationsprogrammausgabe

Nichts

Installer-Rückgabewert

Ein Co-Installer kann NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED oder einen Win32-Fehlercode zurückgeben.

Wenn ein Klasseninstallationsprogramm diese Anforderung erfolgreich verarbeitet und SetupDiCallClassInstaller anschließend den Standardhandler aufrufen sollte, gibt das Klasseninstallationsprogramm ERROR_DI_DO_DEFAULT zurück.

Wenn das Klasseninstallationsprogramm diese Anforderung erfolgreich verarbeitet, einschließlich des direkten Aufrufens des Standardhandlers, sollte der Klasseninstallationsprogramm NO_ERROR zurückgeben, und SetupDiCallClassInstaller ruft den Standardhandler anschließend nicht erneut auf.

Hinweis Das Klasseninstallationsprogramm kann den Standardhandler direkt aufrufen, aber das Klasseninstallationsprogramm sollte niemals versuchen, die Vorgänge des Standardhandlers zu ersetzen.

Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von DIF-Standardcodehandlern.

Wenn beim Klasseninstallationsprogramm ein Fehler auftritt, sollte das Installationsprogramm einen entsprechenden Win32-Fehlercode zurückgeben, und SetupDiCallClassInstaller ruft den Standardhandler anschließend nicht auf.

Standard-DIF-Codehandler

SetupDiRegisterCoDeviceInstallers

Installationsprogrammvorgang

Als Reaktion auf eine DIF_REGISTER_COINSTALLERS Anforderung kann ein Installationsprogramm die Liste der Co-Installer für das Gerät ändern. Ein Installationsprogramm kann beispielsweise programmgesteuert einen gerätespezifischen Co-Installer für das Gerät registrieren oder entfernen, das auf der Analyse des Geräts basiert.

Sofern nicht das DI_NOFILECOPY-Flag festgelegt ist, sollte ein Installationsprogramm, das diese DIF-Anforderung verarbeitet, Dateien kopieren, die für die Co-Installer erforderlich sind.

Wenn das DI_NOFILECOPY-Flag klar ist, aber das DI_NOVCP-Flag festgelegt ist, muss das Installationsprogramm alle Dateivorgänge in die angegebene Dateiwarteschlange quedieren, darf die Warteschlange jedoch nicht committen.

Wenn das Installationsprogramm einen Win32-Fehlercode zurückgibt, beendet Windows die Installation.

Weitere Informationen zu DIF-Codes finden Sie unter Behandeln von DIF-Codes.

Requirements (Anforderungen)

Version	Unterstützt in Microsoft Windows 2000 und höheren Versionen von Windows.
Header	Setupapi.h (einschließlich Setupapi.h)

Weitere Informationen