SetupDiClassNameFromGuidA-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiClassGuidsFromName

SetupDiClassNameFromGuidEx