funzione CM_Get_Device_IDA (cfgmgr32.h)

Articolo
02/26/2024

La funzione CM_Get_Device_ID recupera l'ID istanza del dispositivo per un'istanza del dispositivo specificata nel computer locale.

Nota

In Windows Vista e versioni successive di Windows, il modello di proprietà 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_IDA(
  [in]  DEVINST dnDevInst,
  [out] PSTR    Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Parametri

[in] dnDevInst

Handle dell'istanza del dispositivo fornita dal chiamante associato al computer locale.

[out] Buffer

Indirizzo di un buffer per ricevere una stringa ID istanza del dispositivo. Le dimensioni del buffer necessarie possono essere ottenute chiamando CM_Get_Device_ID_Size, quindi incrementando il valore ricevuto per consentire spazio per la terminazione null della stringa.

[in] BufferLen

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

[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 aggiunge un carattere di terminazione NULL alla stringa ID dell'istanza del dispositivo fornita, a meno che il buffer non sia troppo piccolo per contenere la stringa. In questo caso, la funzione fornisce la maggior parte della stringa dell'identificatore che verrà inserita nel buffer e quindi restituisce CR_BUFFER_SMALL.

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

Per informazioni sull'uso di 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

Vedi anche

CM_Get_Child
CM_Get_Device_ID_Ex

Condividi tramite