funzione CM_Enumerate_EnumeratorsW (cfgmgr32.h)

La funzione CM_Enumerate_Enumerators enumera gli enumeratori del dispositivo del computer locale specificando il nome di ogni enumeratore.

Sintassi

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

Parametri

[in] ulEnumIndex

Indice fornito dal chiamante nell'elenco di enumeratori del dispositivo del computer. Per altre informazioni, vedere la sezione Osservazioni seguenti.

[out] Buffer

Indirizzo di un buffer per ricevere un nome dell'enumeratore. Questo buffer deve essere MAX_DEVICE_ID_LEN dimensioni (o, impostare Buffer su zero e ottenere la lunghezza effettiva del nome nella posizione a cui fa riferimento puLength).

[in, out] pulLength

Indirizzo fornito dal chiamante di una posizione per contenere le dimensioni del buffer. Il chiamante fornisce la lunghezza del buffer a cui punta il buffer. La funzione sostituisce questo valore con la dimensione effettiva della stringa del nome dell'enumeratore. Se la lunghezza del buffer fornita dal chiamante è troppo piccola, la funzione fornisce le dimensioni del buffer necessarie e restituisce CR_BUFFER_SMALL.

[in] ulFlags

Non usato, deve essere zero.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

Per enumerare gli enumeratori del dispositivo del computer locale, chiamare ripetutamente CM_Enumerate_Enumerators , a partire da un valore di indice ulEnumIndex pari a zero. e incrementando il valore dell'indice con ogni chiamata successiva fino a quando la funzione restituisce CR_NO_SUCH_VALUE.

Dopo aver ottenuto i nomi dell'enumeratore, i nomi possono essere usati come input per CM_Get_Device_ID_List.

Requisiti

Vedi anche

CM_Enumerate_Enumerators_Ex