Função SetupDiGetDeviceInfoListClass (setupapi.h)

  • Artigo

A função SetupDiGetDeviceInfoListClass recupera o GUID para a classe de configuração do dispositivo associada a um conjunto de informações do dispositivo se o conjunto tiver uma classe associada.

Sintaxe

WINSETUPAPI BOOL SetupDiGetDeviceInfoListClass(
  [in]  HDEVINFO DeviceInfoSet,
  [out] LPGUID   ClassGuid
);

Parâmetros

[in] DeviceInfoSet

Um identificador para as informações do dispositivo definidas para consulta.

[out] ClassGuid

Um ponteiro para a variável do tipo GUID que recebe o GUID para a classe associada.

Retornar valor

A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.

Comentários

Se o conjunto de informações do dispositivo especificado não tiver uma classe associada porque um GUID de classe não foi especificado quando o conjunto foi criado com SetupDiCreateDeviceInfoList, a função falhará. Nesse caso, uma chamada para GetLastError retorna ERROR_NO_ASSOCIATED_CLASS.

Se um conjunto de informações do dispositivo for para um computador remoto, use SetupDiGetDeviceInfoListDetail para obter o identificador de computador remoto associado e o nome do computador.

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
DLL Setupapi.dll

Confira também

SetupDiCreateDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListDetail