CM_Enumerate_Classes_Ex-Funktion (cfgmgr32.h)

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Enumerate_Classes .]

Die CM_Enumerate_Classes_Ex-Funktion listet bei wiederholtem Aufruf die installierten Geräteklassen eines lokalen Computers oder eines Remotecomputers auf, indem sie die GUID jeder Klasse angibt.

Syntax

CMAPI CONFIGRET CM_Enumerate_Classes_Ex(
  [in]           ULONG    ulClassIndex,
  [out]          LPGUID   ClassGuid,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[in] ulClassIndex

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

[out] ClassGuid

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

[in] ulFlags

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

CM_ENUMERATE_CLASSES_INSTALLER

Auflisten von Gerätesetupklassen.

CM_ENUMERATE_CLASSES_INTERFACE

Auflisten von Geräteschnittstellenklassen.

Andernfalls sollte auf 0 festgelegt werden.

[in, optional] hMachine

Vom Anrufer bereitgestellter Maschinenhandle, der aus einem vorherigen Aufruf von CM_Connect_Machine abgerufen wurde.

Rückgabewert

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

Hinweise

Um die Geräteklassen eines lokalen Computers oder eines Remotecomputers aufzulisten, rufen Sie CM_Enumerate_Classes_Ex wiederholt auf, beginnend mit einem ulClassIndex-Indexwert von 0 und dem Inkrementieren des Indexwerts 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 höheren Betriebssystemen können Aufrufer den ulFlags-Member verwenden, um anzugeben, welche Geräteklassen CM_Enumerate_Classes_Ex zurückgeben sollen. Vor Windows 8 CM_Enumerate_Classes_Ex nur Gerätesetupklassen zurückgegeben.

Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und höheren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn sie unter diesen Windows-Versionen ausgeführt werden.

Anforderungen

Weitere Informationen

CM_Enumerate_Classes