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