SetupDiRegisterCoDeviceInstallers-Funktion (setupapi.h)

  • Artikel

Die SetupDiRegisterCoDeviceInstallers-Funktion ist der Standardhandler für DIF_REGISTER_COINSTALLERS.

Syntax

WINSETUPAPI BOOL SetupDiRegisterCoDeviceInstallers(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in] DeviceInfoSet

Ein Handle für den Geräteinformationssatz , der ein Geräteinformationselement enthält, das das Gerät darstellt, für das Co-Installer registriert werden sollen. Der Geräteinformationssatz darf keine Remoteelemente enthalten.

[in] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA-Struktur , die das Geräteinformationselement in DeviceInfoSet angibt.

Rückgabewert

SetupDiRegisterCoDeviceInstallers gibt TRUE zurück, wenn die Funktion erfolgreich ist. Wenn die Funktion FALSE zurückgibt, rufen Sie GetLastError für erweiterte Fehlerinformationen auf.

Hinweise

Der Aufrufer von SetupDiRegisterCoDeviceInstallers muss Mitglied der Gruppe Administratoren sein.

Hinweis Nur ein Klasseninstallationsprogramm sollte SetupDiRegisterCoDeviceInstallers aufrufen, und zwar nur in den Situationen, in denen der Klasseninstaller Registrierungsvorgänge für das Co-Installationsprogramm ausführen muss, nachdem SetupDiRegisterCoDeviceInstallers den standardmäßigen Registrierungsvorgang für das Co-Installationsprogramm abgeschlossen hat. In solchen Situationen muss das Klasseninstallationsprogramm SetupDiRegisterCoDeviceInstallers direkt aufrufen, wenn das Installationsprogramm eine DIF_REGISTER_COINSTALLERS-Anforderung verarbeitet. Weitere Informationen zum Aufrufen des Standardhandlers finden Sie unter Aufrufen von DIF-Standardcodehandlern.
 
SetupDiRegisterCoDeviceInstallers liest die INF-Datei für das durch DeviceInfoData angegebene Gerät und erstellt Registrierungseinträge, um alle gerätespezifischen Co-Installer zu registrieren, die in der INF-Datei aufgeführt sind. Co-Installer sind in einem ABSCHNITT INF DDInstall.CoInstallers aufgeführt. Diese Funktion kopiert auch die Dateien für die Co-Installer, es sei denn, das flag DI_NOFILECOPY ist festgelegt.

Wenn kein Treiber ausgewählt ist oder das Gerät über eine INF-Datei für Windows 9x oder Millennium Edition verfügt, registriert diese Funktion keine Co-Installer.

Durch das Registrieren eines neuen gerätespezifischen Co-Installers wird die aktuelle Liste der Co-Installer des Geräteinstallationsprogramms ungültig. Nach einer erfolgreichen Registrierung aktualisiert der Geräteinstaller seine Liste der Co-Installer.

Diese Funktion registriert nur gerätespezifische Co-Installer, keine Klassen-Co-Installer.

Weitere Informationen zum Schreiben und Registrieren gerätespezifischer Co-Installer finden Sie unter Schreiben eines Co-Installers.

Der von DeviceInfoSet angegebene Geräteinformationssatz darf nur Elemente auf dem lokalen Computer enthalten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile setupapi.h (schließen Sie Setupapi.h ein)
Bibliothek Setupapi.lib
DLL Setupapi.dll

Weitere Informationen

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller