funzione CM_Get_Device_ID_List_ExA (cfgmgr32.h)

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

La funzione CM_Get_Device_ID_List_Ex recupera un elenco di ID istanza del dispositivo per le istanze del dispositivo in un computer locale o remoto.

Sintassi

CMAPI CONFIGRET CM_Get_Device_ID_List_ExA(
  [in, optional] PCSTR    pszFilter,
  [out]          PZZSTR   Buffer,
  [in]           ULONG    BufferLen,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parametri

[in, optional] pszFilter

Puntatore fornito dal chiamante a una stringa di caratteri che specifica un subset degli identificatori dell'istanza del dispositivo del computer o NULL. Vedere la descrizione seguente di ulFlags.

[out] Buffer

Indirizzo di un buffer per ricevere un set di stringhe di identificatori di istanza del dispositivo con terminazione NULL. La fine del set viene terminata da un valore NULL aggiuntivo. Le dimensioni del buffer necessarie devono essere ottenute chiamando CM_Get_Device_ID_List_Size_Ex.

[in] BufferLen

Lunghezza fornita dal chiamante, in caratteri, del buffer specificato da Buffer.

[in] ulFlags

Uno dei flag di bit facoltativi forniti dal chiamante che specificano i filtri di ricerca. Se non vengono specificati flag, la funzione fornisce tutti gli identificatori di istanza per tutte le istanze del dispositivo. Per un elenco di flag di bit, vedere la descrizione ulFlags per CM_Get_Device_ID_List.

[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 informazioni sugli ID istanza del dispositivo, vedere Stringhe di identificazione del dispositivo.

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