funzione CM_Get_Device_ID_Size_Ex (cfgmgr32.h)
[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Get_Device_ID_Size .]
La funzione CM_Get_Device_ID_Size_Ex recupera le dimensioni del buffer necessarie per contenere un ID istanza del dispositivo per un'istanza del dispositivo in un computer locale o remoto.
Sintassi
CMAPI CONFIGRET CM_Get_Device_ID_Size_Ex(
[out] PULONG pulLen,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parametri
[out] pulLen
Riceve un valore che rappresenta la dimensione del buffer richiesta, espressa in caratteri.
[in] dnDevInst
Handle dell'istanza del dispositivo fornita dal chiamante associato al computer locale.
[in] ulFlags
Non usato, deve essere zero.
[in, optional] hMachine
Handle del computer fornito dal chiamante a cui è associato l'handle dell'istanza del dispositivo fornita dal chiamante.
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_Size_Ex deve essere chiamata per determinare le dimensioni del buffer richieste da CM_Get_Device_ID_Ex.
Il valore di dimensione specificato nella posizione a cui punta pulLen è minore di MAX_DEVICE_ID_LEN e non include il valore NULL di terminazione della stringa dell'identificatore. Se l'istanza del dispositivo specificata non esiste, la funzione fornisce un valore di dimensione pari a zero.
Per informazioni sugli ID istanza del dispositivo, vedere Stringhe di identificazione del dispositivo.
Per informazioni sull'uso di handle di istanza del dispositivo associati a un computer locale o remoto, vedere CM_Get_Child_Ex.
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
| 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 |
| DLL | Cfgmgr32.dll |