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 MIT NULL beendete Zeichenfolge empfängt, die den Namen der Klasse enthält, die vom Zeiger im ClassGuid-parameter angegeben wird.
[in] ClassNameSize
Die Größe des Puffers, auf den der ClassName-Parameter verweist, in Zeichen. 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 der 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 GetLastErrorabgerufen werden.
Bemerkungen
Rufen Sie SetupDiClassNameFromGuidEx- auf, um den Namen einer Klasse auf einem Remotecomputer abzurufen.
SetupDiClassNameFromGuid erzwingt keine Einschränkung für die Länge des Klassennamens, den er zurückgeben kann. Diese Funktion gibt die erforderliche Größe für einen NULL-beendeten Klassennamen zurück, auch wenn sie 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 Class Eintrag eines INF-Versionsabschnitts.
Anmerkung
Der Header setupapi.h 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 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 |