Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |