funzione CM_Get_Device_ID_Size_Ex (cfgmgr32.h)

Articolo
08/22/2023

[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.

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_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

Vedi anche

CM_Get_Child_Ex

CM_Get_Device_ID_Ex

CM_Get_Device_ID_Size

Condividi tramite