Função SetupDiGetHwProfileList (setupapi.h)
A função SetupDiGetHwProfileList recupera uma lista de todas as IDs de perfil de hardware definidas no momento.
Sintaxe
WINSETUPAPI BOOL SetupDiGetHwProfileList(
[out] PDWORD HwProfileList,
[in] DWORD HwProfileListSize,
[out] PDWORD RequiredSize,
[out, optional] PDWORD CurrentlyActiveIndex
);
Parâmetros
[out] HwProfileList
Um ponteiro para uma matriz para receber a lista de IDs de perfil de hardware definidas no momento.
[in] HwProfileListSize
O número de DWORDs no buffer HwProfileList .
[out] RequiredSize
Um ponteiro para uma variável do tipo DWORD que recebe o número de perfis de hardware definidos no momento. Se o número for maior que HwProfileListSize, a lista será truncada para se ajustar ao tamanho da matriz. O valor retornado em RequiredSize indica o tamanho da matriz necessário para armazenar toda a lista de perfis de hardware. Nesse caso, a função falha e uma chamada para GetLastError retorna ERROR_INSUFFICIENT_BUFFER.
[out, optional] CurrentlyActiveIndex
Um ponteiro para uma variável do tipo DWORD que recebe o índice do perfil de hardware atualmente ativo na lista de perfis de hardware recuperada. Esse parâmetro é opcional e pode ser NULL.
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
Chame SetupDiGetHwProfileListEx para recuperar as IDs de perfil de hardware de um computador remoto.
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 |