Compartilhar via


Função SetupDiGetDeviceInfoListDetailA (setupapi.h)

A função SetupDiGetDeviceInfoListDetail recupera informações associadas a um conjunto de informações do dispositivo, incluindo o GUID de 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 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, SetupDiGetDeviceInfoListDetail definirá valores na estrutura de DeviceInfoSetDetailData (exceto para o campo cbSize do ) e retornará NO_ERROR de status.

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

Consulte também

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass