SetupDiRegisterCoDeviceInstallers-Funktion (setupapi.h)
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.
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 |