Função SetupDiGetDeviceInfoListDetailA (setupapi.h)
A função
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 seguinte seção Comentários.
Valor de retorno
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.
Observações
Se os parâmetros forem válidos,
Um chamador de SetupDiGetDeviceInfoListDetail deve definir DeviceInfoSetDetailData.cbSize para tamanhos de(SP_DEVINFO_LIST_DETAIL_DATA) ou a função falhará e a chamada para GetLastError retornará 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 CM_xxx_Ex funções porque as alças de DevInst são relativas 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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
da Plataforma de Destino |
Área de trabalho |
cabeçalho | setupapi.h (inclua Setupapi.h) |
biblioteca | Setupapi.lib |