SetupDiClassGuidsFromNameA-Funktion (setupapi.h)

  • Artikel

Die SetupDiClassGuidsFromName-Funktion ruft die GUID ab, die dem angegebenen Klassennamen zugeordnet sind. 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-Array .

[out] RequiredSize

Stellt einen Zeiger auf eine Variable bereit, die die Anzahl von 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 durch einen Aufruf von GetLastError abgerufen werden.

Hinweise

Rufen Sie SetupDiClassGuidsFromNameEx auf, um die Klassen-GUIDs für eine Klasse auf einem Remotecomputer abzurufen.

Hinweis

Der setupapi.h-Header definiert SetupDiClassGuidsFromName 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

   
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

SetupDiClassGuidsFromNameEx

SetupDiClassNameFromGuid