CM_Enumerate_Enumerators_ExW-Funktion (cfgmgr32.h)

Artikel
03/04/2024

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

Die CM_Enumerate_Enumerators_Ex-Funktion listet die Geräteumeratoren eines lokalen Computers oder eines Remotecomputers auf, indem sie den Namen jedes Enumerators angibt.

Syntax

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

Parameter

[in] ulEnumIndex

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

[out] Buffer

Adresse eines Puffers, um einen Enumeratornamen zu empfangen. 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 angegebene Adresse eines Speicherorts für die Puffergröße. Der Aufrufer gibt die Länge des Puffers an, auf den puffer 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, stellt die Funktion die erforderliche Puffergröße bereit und gibt CR_BUFFER_SMALL zurück.

[in] ulFlags

Nicht verwendet, muss null sein.

[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äteumeratoren des lokalen Computers oder eines Remotecomputers aufzuzählen, rufen Sie CM_Enumerate_Enumerators_Ex wiederholt auf, beginnend mit einem ulEnumIndex-Indexwert von 0, 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 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

Weitere Informationen

CM_Enumerate_Enumerators

Freigeben über