funzione CM_Get_Device_ID_List_Size_ExA (cfgmgr32.h)

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

La funzione CM_Get_Device_ID_List_Size_Ex recupera le dimensioni del buffer necessarie per contenere un elenco di ID istanza del dispositivo per le istanze del dispositivo locali o remote.

Sintassi

CMAPI CONFIGRET CM_Get_Device_ID_List_Size_ExA(
  [out]          PULONG   pulLen,
  [in, optional] PCSTR    pszFilter,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parametri

[out] pulLen

Riceve un valore che rappresenta la dimensione del buffer richiesta, espressa in caratteri.

[in, optional] pszFilter

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

[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 le dimensioni del buffer necessarie per contenere 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_Ex.

[in, optional] hMachine

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

Nota L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.

 

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

La funzione CM_Get_Device_ID_List_Size_Ex deve essere chiamata per determinare le dimensioni del buffer richieste da CM_Get_Device_ID_List_Ex.

Il valore di dimensione fornito nella posizione a cui punta pulLen è garantito che rappresenti una dimensione del buffer sufficientemente grande da contenere tutte le stringhe dell'identificatore dell'istanza del dispositivo e terminando gli NUL. Il valore fornito potrebbe effettivamente rappresentare una dimensione del buffer maggiore del necessario, quindi non presupporre che il valore rappresenti la lunghezza vera delle stringhe di caratteri che CM_Get_Device_ID_List_Ex fornirà.

Per informazioni sugli ID istanza del dispositivo, vedere Stringhe di identificazione del dispositivo.

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

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib

Vedi anche

CM_Get_Device_ID_List_Size