Função SetupDiGetDeviceInfoListDetailA (setupapi.h)
A função SetupDiGetDeviceInfoListDetail recupera informações associadas a um conjunto de informações do dispositivo, incluindo o GUID da classe, o identificador de computador remoto e o nome do computador remoto.
Sintaxe
WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailA(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_LIST_DETAIL_DATA_A DeviceInfoSetDetailData
);
Parâmetros
[in] DeviceInfoSet
Um identificador para o conjunto de informações do dispositivo para o qual recuperar informações.
[out] DeviceInfoSetDetailData
Um ponteiro para uma estrutura de SP_DEVINFO_LIST_DETAIL_DATA inicializada pelo chamador que recebe as informações do conjunto de informações do dispositivo. Para obter mais informações sobre essa estrutura, consulte a seção Comentários a seguir.
Retornar valor
A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado fazendo uma chamada para GetLastError.
Comentários
Se os parâmetros forem válidos, SetupDiGetDeviceInfoListDetail definirá valores na estrutura DeviceInfoSetDetailData (exceto para o campo cbSize) e retornará status NO_ERROR.
Um chamador de SetupDiGetDeviceInfoListDetail deve definir DeviceInfoSetDetailData.cbSize to sizeof(SP_DEVINFO_LIST_DETAIL_DATA) or the function will fail and the call to GetLastError will return ERROR_INVALID_USER_BUFFER.
Se SetupDiGetDeviceInfoListDetail for concluído com êxito , DeviceInfoSetDetailData.ClassGuid contém o GUID de classe associado ao conjunto de informações do dispositivo ou a uma estrutura GUID_NULL.
Se SetupDiGetDeviceInfoListDetail for concluído com êxito e o conjunto de informações do dispositivo for para um sistema remoto, DeviceInfoSetDetailData.RemoteMachineHandle contém o identificador do sistema ConfigMgr32 para acessar o sistema remoto e DeviceInfoSetDetailData.RemoteMachineName contém o nome do sistema remoto. Se houver um identificador remoto para o conjunto de informações do dispositivo, ele deverá ser usado ao chamar funções CM_Xxx_Ex porque os identificadores DevInst são relativos ao identificador remoto.
Se o conjunto de informações do dispositivo for para o computador local, DeviceInfoSetDetailData.RemoteMachineHandle é NULL e DeviceInfoSetDetailData.RemoteMachineName é uma cadeia de caracteres vazia.
Observação
O cabeçalho setupapi.h define SetupDiGetDeviceInfoListDetail como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |