funzione CM_Enumerate_Enumerators_ExA (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 del dispositivo locale o remoto, specificando il nome di ogni enumeratore.

Sintassi

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

Parametri

[in] ulEnumIndex

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

[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 in cui contenere le dimensioni del buffer. Il chiamante fornisce la lunghezza del buffer a cui punta Buffer. La funzione sostituisce questo valore con le dimensioni effettive 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 macchina 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 di un computer remoto, chiamare ripetutamente CM_Enumerate_Enumerators_Ex , a partire da un valore di indice ulEnumIndex pari a zero e incrementare il valore dell'indice con ogni chiamata successiva fino a quando la funzione non 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.

Le funzionalità per accedere ai computer remoti sono state rimosse nei sistemi operativi Windows 8 e Windows Server 2012 e versioni successive, pertanto non è possibile accedere ai computer remoti durante l'esecuzione in queste versioni di Windows.

Requisiti

Vedi anche

CM_Enumerate_Enumerators