funzione CM_Get_Device_ID_ExA (cfgmgr32.h)

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

La funzione CM_Get_Device_ID_Ex recupera l'ID istanza del dispositivo per un'istanza del dispositivo specificata in un computer locale o remoto.

Sintassi

CMAPI CONFIGRET CM_Get_Device_ID_ExA(
  [in]           DEVINST  dnDevInst,
  [out]          PSTR     Buffer,
  [in]           ULONG    BufferLen,
                 ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parametri

[in] dnDevInst

Handle dell'istanza del dispositivo fornita dal chiamante associato all'handle del computer fornito da hMachine.

[out] Buffer

Indirizzo di un buffer per ricevere una stringa ID istanza del dispositivo. È possibile ottenere le dimensioni del buffer necessarie chiamando CM_Get_Device_ID_Size_Ex, 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.

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 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 a un computer locale o remoto, vedere CM_Get_Child_Ex.

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

Vedi anche

CM_Get_Child_Ex
CM_Get_Device_ID