SetupDiClassGuidsFromNameExA-Funktion (setupapi.h)

  • Artikel

Die SetupDiClassGuidsFromNameEx-Funktion ruft die GUIDs ab, die dem angegebenen Klassennamen zugeordnet sind. Diese resultierende Liste enthält die Klassen, die derzeit auf einem lokalen Oder Remotecomputer installiert sind.

Syntax

WINSETUPAPI BOOL SetupDiClassGuidsFromNameExA(
  [in]           PCSTR  ClassName,
  [out]          LPGUID ClassGuidList,
  [in]           DWORD  ClassGuidListSize,
  [out]          PDWORD RequiredSize,
  [in, optional] PCSTR  MachineName,
                 PVOID  Reserved
);

Parameter

[in] ClassName

Der Name der Klasse, für die die Klassen-GUIDs abgerufen werden sollen.

[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

Ein Zeiger auf eine Variable, 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.

[in, optional] MachineName

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen eines Remotesystems enthält, von dem die GUIDs abgerufen werden sollen. Dieser Parameter ist optional und kann NULL sein. Wenn MachineNameNULL ist, wird der lokale Systemname verwendet.

Achtung

Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.

Reserved

Muss NULL sein.

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

Klassennamen sind nicht garantiert eindeutig. nur GUIDs sind eindeutig. Daher kann ein Klassenname mehr als eine GUID zurückgeben.

Hinweis

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