SetupDiCreateDeviceInfoListExA-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiCreateDeviceInfoList

SetupDiDestroyDeviceInfoList

SetupDiGetDeviceInfoListDetail