SetupDiClassGuidsFromNameA-Funktion (setupapi.h)
Die SetupDiClassGuidsFromName Funktion ruft die GUID(n) ab, die dem angegebenen Klassennamen zugeordnet ist. 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 Arrays.
[out] RequiredSize
Stellt einen Zeiger auf eine Variable bereit, 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.
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
Rufen Sie SetupDiClassGuidsFromNameEx- auf, um die Klassen-GUIDs für eine Klasse auf einem Remotecomputer abzurufen.
Anmerkung
Der Header setupapi.h definiert SetupDiClassGuidsFromName 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 |