CM_Enumerate_EnumeratorsA-Funktion (cfgmgr32.h)

  • Artikel

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

Syntax

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

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.

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 aufzulisten, rufen Sie CM_Enumerate_Enumerators 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.

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_Ex