CM_Enumerate_Classes_Ex-Funktion (cfgmgr32.h)

Artikel
03/01/2024

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

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

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

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

Weitere Informationen

CM_Enumerate_Classes

Freigeben über