SetupDiClassGuidsFromNameExA-Funktion (setupapi.h)
Die SetupDiClassGuidsFromNameEx--Funktion ruft die GUIDs ab, die dem angegebenen Klassennamen zugeordnet sind. Diese resultierende Liste enthält die Klassen, die derzeit auf einem lokalen oder Remotecomputer installiert sind.
Syntax
WINSETUPAPI BOOL SetupDiClassGuidsFromNameExA(
[in] PCSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parameter
[in] ClassName
Der Name der Klasse, für die die Klassen-GUIDs abgerufen werden sollen.
[out] ClassGuidList
Ein Zeiger auf ein Array, um die Liste der GUIDs zu empfangen, die dem angegebenen Klassennamen zugeordnet sind.
[in] ClassGuidListSize
Die Anzahl der GUIDs im ClassGuidList Arrays.
[out] RequiredSize
Ein Zeiger auf eine Variable, die die Anzahl der GUIDs empfängt, die dem Klassennamen zugeordnet sind. Wenn diese Zahl größer als die Größe des ClassGuidList- Puffers ist, gibt die Zahl an, wie groß das Array sein muss, um alle GUIDs zu speichern.
[in, optional] MachineName
Ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die den Namen eines Remotesystems enthält, aus dem die GUIDs abgerufen werden sollen. Dieser Parameter ist optional und kann NULL-werden. Wenn MachineName-NULL-ist, wird der lokale Systemname verwendet.
Vorsicht
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 TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann abgerufen werden, indem ein Aufruf an GetLastError-ausgeführt wird.
Bemerkungen
Klassennamen sind nicht garantiert eindeutig; nur GUIDs sind eindeutig. Daher kann ein Klassenname mehrere GUID zurückgeben.
Anmerkung
Der header setupapi.h definiert SetupDiClassGuidsFromNameEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |