Funzione SetupDiGetDeviceInfoListDetailA (setupapi.h)

  • Articolo

La funzione SetupDiGetDeviceInfoListDetail recupera informazioni associate a un set di informazioni sul dispositivo, tra cui il GUID di classe, l'handle 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 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 seguenti.

Valore restituito

La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato eseguendo 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 completa correttamente e il set di informazioni sul dispositivo è per un sistema remoto, DeviceInfoSetDetailData.RemoteMachineHandle contiene l'handle di sistema ConfigMgr32 per accedere al sistema remoto e DeviceInfoSetDetailData.RemoteMachineName contiene il nome del sistema remoto. Se è presente un handle remoto per il set di informazioni sul dispositivo, deve essere usato 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione setupapi.h (includere Setupapi.h)
Libreria Setupapi.lib

Vedi anche

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass