SetupDiCreateDeviceInfoListExA-Funktion (setupapi.h)
Die SetupDiCreateDeviceInfoList-Funktion erstellt einen leeren Geräteinformationssatz auf einem Remote- oder lokalen Computer und ordnet den Satz optional einer Gerätesetupklasse zu.
Syntax
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parameter
[in, optional] ClassGuid
Ein Zeiger auf die GUID der Gerätesetupklasse, die dem neu erstellten Geräteinformationssatz zugeordnet werden soll. Wenn dieser Parameter angegeben ist, können nur Geräte dieser Klasse in diesen Geräteinformationssatz eingeschlossen werden. Wenn dieser Parameter auf NULL festgelegt ist, ist der Geräteinformationssatz keiner bestimmten Gerätesetupklasse zugeordnet.
[in, optional] hwndParent
Ein Handle für das Fenster der obersten Ebene, das für jede Benutzeroberfläche verwendet werden soll, die sich auf nicht gerätespezifische Aktionen bezieht (z. B. ein Dialogfeld "Gerät auswählen", in dem die globale Klassentreiberliste verwendet wird). Dieses Handle ist optional und kann NULL sein. Wenn ein bestimmtes Fenster der obersten Ebene nicht erforderlich ist, legen Sie hwndParent auf NULL fest.
[in, optional] MachineName
Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen eines Computers in einem Netzwerk enthält. Wenn ein Name angegeben wird, können in diesem Geräteinformationssatz nur Geräte auf diesem Computer erstellt und geöffnet werden. Wenn dieser Parameter auf NULL festgelegt ist, gilt der Geräteinformationssatz für Geräte auf dem lokalen Computer.
Achtung
Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.
Reserved
Muss NULL sein.
Rückgabewert
Die Funktion gibt bei erfolgreicher Ausführung ein Handle an einen leeren Geräteinformationssatz zurück. Andernfalls wird INVALID_HANDLE_VALUE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Der Aufrufer dieser Funktion muss die zurückgegebenen Geräteinformationen löschen, wenn sie nicht mehr benötigt werden, indem SetupDiDestroyDeviceInfoList aufgerufen wird.
Wenn der Geräteinformationssatz für Geräte auf einem Remotecomputer bestimmt ist (MachineName ist nicht NULL), müssen alle nachfolgenden Vorgänge für diese Gruppe oder eines seiner Elemente Routinen verwenden, die Geräteinformationsgruppen mit Remoteelementen unterstützen. Die SetupDiXxx-Routinen , die diese Unterstützung nicht bieten, z. B . SetupDiCallClassInstaller, enthalten eine entsprechende Anweisung auf ihrer Referenzseite.
Hinweis
Der setupapi.h-Header definiert SetupDiCreateDeviceInfoListEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |