funzione CM_Get_Device_ID_Size (cfgmgr32.h)

  • Articolo

La funzione CM_Get_Device_ID_Size recupera le dimensioni del buffer necessarie per contenere un ID istanza del dispositivo per un'istanza del dispositivo nel computer locale.

Nota

In Windows Vista e versioni successive di Windows, il modello di proprietà del dispositivo unificato usa la chiave della proprietàDEVPKEY_Device_InstanceId per rappresentare l'identificatore dell'istanza del dispositivo. Per informazioni dettagliate, vedere Recupero di un identificatore di istanza del dispositivo .

Sintassi

CMAPI CONFIGRET CM_Get_Device_ID_Size(
  [out] PULONG  pulLen,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

Parametri

[out] pulLen

Riceve un valore che rappresenta le dimensioni del buffer necessarie, in caratteri.

[in] dnDevInst

Handle di istanza del dispositivo fornito dal chiamante associato al computer locale.

[in] ulFlags

Non usato, deve essere zero.

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 deve essere chiamata per determinare le dimensioni del buffer richieste da CM_Get_Device_ID.

Il valore di dimensione fornito nella posizione a cui punta pulLen è minore di MAX_DEVICE_ID_LEN e non include la terminazione NULL della stringa di 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 degli handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Universale
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib; OneCoreUAP.lib in Windows 10
DLL CfgMgr32.dll

Vedi anche

CM_Get_Child

CM_Get_Device_ID

CM_Get_Device_ID_Size_Ex