CM_Enumerate_Enumerators_ExA-Funktion (cfgmgr32.h)

Artikel
08/22/2023

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

Die CM_Enumerate_Enumerators_Ex-Funktion listet einen lokalen oder die Geräteenumeratoren eines Remotecomputers auf, indem der Name jedes Enumerators angegeben wird.

Syntax

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExA(
  [in]           ULONG    ulEnumIndex,
  [out]          PSTR     Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[in] ulEnumIndex

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

[out] Buffer

Adresse eines Puffers, der einen Enumeratornamen empfangen soll. Dieser Puffer sollte MAX_DEVICE_ID_LEN Größe haben (oder Puffer auf null festlegen und die tatsächliche Namenslänge an der Position abrufen, auf die von puLength verwiesen wird).

[in, out] pulLength

Vom Aufrufer bereitgestellte Adresse eines Speicherorts, der die Puffergröße enthalten soll. Der Aufrufer gibt die Länge des Puffers an, auf den buffer verweist. Die Funktion ersetzt diesen Wert durch die tatsächliche Größe der Namenszeichenfolge des Enumerators. Wenn die vom Aufrufer bereitgestellte Pufferlänge zu klein ist, liefert die Funktion die erforderliche Puffergröße und gibt CR_BUFFER_SMALL zurück.

[in] ulFlags

Nicht verwendet, muss null sein.

[in, optional] hMachine

Vom Aufrufer 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 in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

Um die geräteumeratoren des lokalen Computers oder die Geräteenumeratoren eines Remotecomputers aufzulisten, rufen Sie CM_Enumerate_Enumerators_Ex wiederholt auf, beginnend mit einem ulEnumIndex-Indexwert von 0 (null), und erhöhen Sie den Indexwert mit jedem nachfolgenden Aufruf, bis die Funktion CR_NO_SUCH_VALUE zurückgibt.

Nachdem Enumeratornamen abgerufen wurden, können die Namen als Eingabe für CM_Get_Device_ID_List verwendet werden.

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

Anforderungen


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

Weitere Informationen

CM_Enumerate_Enumerators

Freigeben über