Função SetupDiCreateDeviceInfoListExA (setupapi.h)
A função
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 instalaçã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 será 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 usado 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 driver 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 para 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 a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.
Reserved
Deve ser NULL.
Valor de retorno
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.
Observações
O chamador dessa função deve excluir o conjunto de informações de 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 for NULL), todas as operações subsequentes nesse conjunto ou qualquer um de seus elementos deverão usar rotinas que dão suporte a conjuntos de informações do dispositivo com elementos remotos. As rotinas de SetupDixxx que não fornecem esse suporte, como SetupDiCallClassInstaller, têm uma instrução para esse efeito em sua página de referência.
Nota
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 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 |