Funzione SetupDiGetDeviceInfoListDetailA (setupapi.h)
La funzione SetupDiGetDeviceInfoListDetail recupera le informazioni associate a un set di informazioni sul dispositivo, tra cui il GUID della classe, l'handle del computer remoto e il nome del computer remoto.
Sintassi
WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailA(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_LIST_DETAIL_DATA_A DeviceInfoSetDetailData
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo per cui recuperare le informazioni.
[out] DeviceInfoSetDetailData
Puntatore a una struttura di SP_DEVINFO_LIST_DETAIL_DATA inizializzata dal chiamante che riceve le informazioni sul set di informazioni sul dispositivo. Per altre informazioni su questa struttura, vedere la sezione osservazioni
Valore restituito
Se ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError.
Osservazioni
Se i parametri sono validi, SetupDiGetDeviceInfoListDetail imposta i valori nella struttura DeviceInfoSetDetailData (ad eccezione del campo cbSize) e restituisce lo stato NO_ERROR.
Un chiamante di SetupDiGetDeviceInfoListDetail deve impostare DeviceInfoSetDetailData.cbSize per sizeof(SP_DEVINFO_LIST_DETAIL_DATA) o la funzione avrà esito negativo e la chiamata a GetLastError restituirà ERROR_INVALID_USER_BUFFER.
Se SetupDiGetDeviceInfoListDetail completato correttamente, DeviceInfoSetDetailData.ClassGuid contiene il GUID della classe associato al set di informazioni sul dispositivo o una struttura di GUID_NULL.
Se SetupDiGetDeviceInfoListDetail viene completato correttamente e il set di informazioni sul dispositivo è per un sistema remoto, DeviceInfoSetDetailData.RemoteMachineHandle contiene l'handle di sistema ConfigMgr32 per l'accesso al sistema remoto e DeviceInfoSetDetailData.RemoteMachineName contiene il nome del sistema remoto. Se è presente un handle remoto per il set di informazioni sul dispositivo, è necessario usarlo quando si chiama CM_xxx_Ex funzioni perché gli handle DevInst sono relativi all'handle remoto.
Se il set di informazioni sul dispositivo è per il computer locale, DeviceInfoSetDetailData. RemoteMachineHandle è NULL e DeviceInfoSetDetailData.remoteMachineName è una stringa vuota.
Nota
L'intestazione setupapi.h definisce SetupDiGetDeviceInfoListDetail come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| piattaforma di destinazione | Desktop |
| intestazione |
setupapi.h (include Setupapi.h) |
| libreria |
Setupapi.lib |