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-Array .
[out] RequiredSize
Ein Zeiger auf eine Variable, die die Anzahl von 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 NULL-beendete Zeichenfolge, die den Namen eines Remotesystems enthält, von dem die GUIDs abgerufen werden sollen. Dieser Parameter ist optional und kann NULL sein. Wenn MachineNameNULL ist, wird der lokale Systemname verwendet.
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 TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.
Hinweise
Klassennamen sind nicht garantiert eindeutig. nur GUIDs sind eindeutig. Daher kann ein Klassenname mehr als eine GUID zurückgeben.
Hinweis
Der setupapi.h-Header definiert SetupDiClassGuidsFromNameEx 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 |