CM_Enumerate_Classes-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Enumerate_Classes-Funktion listet bei wiederholtem Aufruf die auf dem lokalen Computer installierten Geräteklassen auf, indem sie die GUID der einzelnen Klassen angibt.

Syntax

CMAPI CONFIGRET CM_Enumerate_Classes(
  [in]  ULONG  ulClassIndex,
  [out] LPGUID ClassGuid,
  [in]  ULONG  ulFlags
);

Parameter

[in] ulClassIndex

Vom Aufrufer bereitgestellter Index in der Liste der Geräteklassen des Computers. Weitere Informationen finden Sie im Abschnitt Hinweise.

[out] ClassGuid

Vom Aufrufer bereitgestellte Adresse einer GUID-Struktur (beschrieben im Microsoft Windows SDK), um die GUID einer Geräteklasse zu empfangen.

[in] ulFlags

Ab Windows 8 können Aufrufer die folgenden Flags angeben:

CM_ENUMERATE_CLASSES_INSTALLER

Auflisten von Gerätesetupklassen.

CM_ENUMERATE_CLASSES_INTERFACE

Auflisten von Geräteschnittstellenklassen.

Andernfalls sollte auf 0 (null) festgelegt werden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

Um die Geräteklassen des lokalen Computers aufzulisten, rufen Sie CM_Enumerate_Classes wiederholt auf, beginnend mit einem ulClassIndex-Wert von 0 (null), und erhöhen Sie den Indexwert mit jedem nachfolgenden Aufruf, bis die Funktion CR_NO_SUCH_VALUE zurückgibt. Einige Indexwerte können Listeneinträge darstellen, die ungültige Klassendaten enthalten. In diesem Fall gibt die Funktion CR_INVALID_DATA zurück. Dieser Rückgabewert kann ignoriert werden.

Die von dieser Funktion abgerufenen Klassen-GUIDs können als Eingabe für die Geräteinstallationsfunktionen verwendet werden.

Ab Windows 8 und späteren Betriebssystemen können Aufrufer den ulFlags-Member verwenden, um anzugeben, welche Geräteklassen CM_Enumerate_Classes zurückgeben sollen. Vor Windows 8 CM_Enumerate_Classes nur Gerätesetupklassen zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib
DLL Cfgmgr32.dll

Weitere Informationen

CM_Enumerate_Classes_Ex