Freigeben über


SetupDiClassGuidsFromNameW-Funktion (setupapi.h)

Die SetupDiClassGuidsFromName Funktion ruft die GUID(n) ab, die dem angegebenen Klassennamen zugeordnet ist. Diese Liste basiert auf den klassen, die derzeit auf dem System installiert sind.

Syntax

WINSETUPAPI BOOL SetupDiClassGuidsFromNameW(
  [in]  PCWSTR 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 Arrays.

[out] RequiredSize

Stellt einen Zeiger auf eine Variable bereit, die die Anzahl der 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 abgerufen werden, indem ein Aufruf an GetLastError-ausgeführt wird.

Bemerkungen

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

Anmerkung

Der Header setupapi.h definiert SetupDiClassGuidsFromName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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

Siehe auch

SetupDiClassGuidsFromNameEx-

SetupDiClassNameFromGuid-