SetupDiClassNameFromGuidA-Funktion (setupapi.h)
Die SetupDiClassNameFromGuid-Funktion ruft den Klassennamen ab, der einer Klassen-GUID zugeordnet ist.
Syntax
WINSETUPAPI BOOL SetupDiClassNameFromGuidA(
[in] const GUID *ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] ClassGuid
Ein Zeiger auf die Klassen-GUID für den abzurufenden Klassennamen.
[out] ClassName
Ein Zeiger auf einen Puffer, der die NULL-beendete Zeichenfolge empfängt, die den Namen der Klasse enthält, die durch den Zeiger im ClassGuid-Parameter angegeben wird.
[in] ClassNameSize
Die Größe des Puffers in Zeichen, auf den der ClassName-Parameter verweist. Die maximale Größe eines NULL-beendeten Klassennamens in Zeichen ist MAX_CLASS_NAME_LEN. Weitere Informationen zur Größe des Klassennamens finden Sie im folgenden Abschnitt Hinweise .
[out, optional] RequiredSize
Ein Zeiger auf eine Variable, die die Anzahl von Zeichen empfängt, die zum Speichern des angeforderten NULL-beendeten Klassennamens erforderlich sind. Dieser Zeiger ist optional und kann NULL sein.
Rückgabewert
Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastError abgerufen werden.
Hinweise
Rufen Sie SetupDiClassNameFromGuidEx auf, um den Namen für eine Klasse auf einem Remotecomputer abzurufen.
SetupDiClassNameFromGuid erzwingt keine Einschränkung für die Länge des Klassennamens, den es zurückgeben kann. Diese Funktion gibt die erforderliche Größe für einen MIT NULL beendeten Klassennamen zurück, auch wenn er größer als MAX_CLASS_NAME_LEN ist. MAX_CLASS_NAME_LEN ist jedoch die maximale Länge eines gültigen NULL-beendeten Klassennamens. Ein Aufrufer sollte niemals einen Puffer benötigen, der größer als MAX_CLASS_NAME_LEN ist. Weitere Informationen zu Klassennamen finden Sie in der Beschreibung des Klasseneintrags einer INF-Version.
Hinweis
Der setupapi.h-Header definiert SetupDiClassNameFromGuid 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 |