CM_Enumerate_Classes-Funktion (cfgmgr32.h)

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

Weitere Informationen

CM_Enumerate_Classes_Ex