Função SetupDiCreateDeviceInfoListExA (setupapi.h)
A função SetupDiCreateDeviceInfoList cria um conjunto de informações de dispositivo vazio em um computador remoto ou local e, opcionalmente, associa o conjunto a uma classe de configuração do dispositivo .
Sintaxe
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parâmetros
[in, optional] ClassGuid
Um ponteiro para o GUID da classe de configuração do dispositivo a ser associado ao conjunto de informações do dispositivo recém-criado. Se esse parâmetro for especificado, somente dispositivos dessa classe poderão ser incluídos neste conjunto de informações do dispositivo. Se esse parâmetro for definido como NULL, o conjunto de informações do dispositivo não estará associado a uma classe de configuração de dispositivo específica.
[in, optional] hwndParent
Um identificador para a janela de nível superior a ser usada para qualquer interface do usuário relacionada a ações não específicas do dispositivo (como uma caixa de diálogo select-device que usa a lista de drivers de classe global). Esse identificador é opcional e pode ser NULL. Se uma janela de nível superior específica não for necessária, defina hwndParent como NULL.
[in, optional] MachineName
Um ponteiro para uma cadeia de caracteres terminada em NULL que contém o nome de um computador em uma rede. Se um nome for especificado, somente os dispositivos nesse computador poderão ser criados e abertos neste conjunto de informações do dispositivo. Se esse parâmetro for definido como NULL, o conjunto de informações do dispositivo será para dispositivos no computador local.
Cuidado
Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
Reserved
Deve ser NULL.
Retornar valor
A função retorna um identificador para um conjunto de informações de dispositivo vazio se for bem-sucedida. Caso contrário, ele retornará INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O chamador dessa função deve excluir o conjunto de informações do dispositivo retornado quando ele não for mais necessário chamando SetupDiDestroyDeviceInfoList.
Se o conjunto de informações do dispositivo for para dispositivos em um computador remoto (MachineName não é NULL), todas as operações subsequentes nesse conjunto ou qualquer um de seus elementos devem usar rotinas que dão suporte a conjuntos de informações do dispositivo com elementos remotos. As rotinas SetupDiXxx que não fornecem esse suporte, como SetupDiCallClassInstaller, têm uma instrução para esse efeito em sua página de referência.
Observação
O cabeçalho setupapi.h define SetupDiCreateDeviceInfoListEx 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 |