SetupDiClassGuidsFromNameA-Funktion (setupapi.h)
Die SetupDiClassGuidsFromName-Funktion ruft die GUID ab, die dem angegebenen Klassennamen zugeordnet sind. Diese Liste basiert auf den Klassen, die derzeit auf dem System installiert sind.
Syntax
WINSETUPAPI BOOL SetupDiClassGuidsFromNameA(
[in] PCSTR ClassName,
[out] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
Parameter
[in] ClassName
Der Name der Klasse, für die die Klassen-GUID abgerufen werden soll.
[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
Stellt einen Zeiger auf eine Variable bereit, 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.
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
Rufen Sie SetupDiClassGuidsFromNameEx auf, um die Klassen-GUIDs für eine Klasse auf einem Remotecomputer abzurufen.
Hinweis
Der setupapi.h-Header definiert SetupDiClassGuidsFromName 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
| 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 |