funzione CM_Enumerate_Enumerators_ExW (cfgmgr32.h)

[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Enumerate_Enumerators .]

La funzione CM_Enumerate_Enumerators_Ex enumera un enumeratore locale o remoto del computer, fornendo il nome di ogni enumeratore.

Sintassi

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExW(
  [in]           ULONG    ulEnumIndex,
  [out]          PWSTR    Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

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.

[in, optional] hMachine

Handle del computer fornito dal chiamante, ottenuto da una chiamata precedente a CM_Connect_Machine.

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 locale o remoto, chiamare ripetutamente CM_Enumerate_Enumerators_Ex, 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.

La funzionalità per accedere ai computer remoti è stata rimossa in Windows 8 e Windows Server 2012 e sistemi operativi successivi, pertanto non è possibile accedere ai computer remoti quando vengono eseguiti in queste versioni di Windows.

Requisiti

Vedi anche

CM_Enumerate_Enumerators