CM_Enumerate_EnumeratorsA-Funktion (cfgmgr32.h)
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 |