Função SetupDiGetDeviceInfoListDetailA (setupapi.h)

  • Artigo

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

Confira também

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass