CM_Enumerate_EnumeratorsW-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Enumerate_Enumerators-Funktion listet die Geräteenumeratoren des lokalen Computers auf, indem sie den Namen jedes Enumerators angibt.

Syntax

CMAPI CONFIGRET CM_Enumerate_EnumeratorsW(
  [in]      ULONG  ulEnumIndex,
  [out]     PWSTR  Buffer,
  [in, out] PULONG pulLength,
  [in]      ULONG  ulFlags
);

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.

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äteenumeratoren des lokalen Computers aufzulisten, rufen Sie CM_Enumerate_Enumerators wiederholt auf, beginnend mit einem ulEnumIndex-Indexwert von null. und erhöhen 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.

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

Weitere Informationen

CM_Enumerate_Enumerators_Ex