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
| 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 |