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 il quale 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 seguente.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError.

Commenti

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 a sizeof(SP_DEVINFO_LIST_DETAIL_DATA) o la funzione avrà esito negativo e la chiamata a GetLastError restituirà ERROR_INVALID_USER_BUFFER.

Se SetupDiGetDeviceInfoListDetail viene completato correttamente, DeviceInfoSetDetailData.ClassGuid contiene il GUID della classe associato al set di informazioni sul dispositivo o una struttura 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

   
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

Vedi anche

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass