Função SetupDiCreateDeviceInterfaceRegKeyA (setupapi.h)
A função SetupDiCreateDeviceInterfaceRegKey cria uma chave do Registro para armazenar informações sobre uma interface do dispositivo e retorna um identificador para a chave.
Sintaxe
WINSETUPAPI HKEY SetupDiCreateDeviceInterfaceRegKeyA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired,
[in, optional] HINF InfHandle,
[in, optional] PCSTR InfSectionName
);
Parâmetros
[in] DeviceInfoSet
Um identificador para um conjunto de informações do dispositivo que contém a interface para a qual criar uma chave do Registro. O conjunto de informações do dispositivo não deve conter elementos remotos.
[in] DeviceInterfaceData
Um ponteiro para uma estrutura SP_DEVICE_INTERFACE_DATA que especifica a interface do dispositivo em DeviceInfoSet. Esse ponteiro é possivelmente retornado por SetupDiCreateDeviceInterface.
Reserved
Reservado. Deve ser zero.
[in] samDesired
O acesso de segurança do Registro que o chamador solicita para a chave que está sendo criada. Para obter informações sobre os valores de acesso de segurança do Registro do tipo REGSAM, consulte a documentação do SDK do Microsoft Windows.
[in, optional] InfHandle
O identificador para um arquivo INF aberto que contém uma seção DDInstall a ser executada para a chave recém-criada. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro não for NULL, InfSectionName também deverá ser especificado.
[in, optional] InfSectionName
Um ponteiro para o nome de uma seção INF DDInstall no arquivo INF especificado por InfHandle. Esta seção é executada para a chave recém-criada. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for especificado, InfHandle também deverá ser especificado.
Retornar valor
Se SetupDiCreateDeviceInterfaceRegKey for bem-sucedida, a função retornará um identificador para a chave do Registro solicitada na qual as informações da interface podem ser armazenadas e recuperadas. Se SetupDiCreateDeviceInterfaceRegKey falhar, a função retornará INVALID_HANDLE_VALUE. Chame GetLastError para obter informações de erro estendidas.
Comentários
O chamador dessa função deve ser membro do grupo Administradores.
Se a chave solicitada para a interface do dispositivo já existir, SetupDiCreateDeviceInterfaceRegKey retornará um identificador para essa chave; caso contrário, SetupDiCreateDeviceInterfaceRegKey cria uma nova chave do Registro não volátil para a interface do dispositivo especificada. Os chamadores dessa função podem armazenar dados de configuração particulares para a interface do dispositivo nessa chave. O driver do dispositivo pode acessar essa chave usando rotinas IoXxx .
Feche o identificador retornado dessa função chamando RegCloseKey.
Para instalações que usam arquivos de layout (especificados pela entrada LayoutFile em uma seção versão inf), o arquivo de layout deve ser aberto por uma chamada para SetupOpenAppendInfFile (descrito em SDK do Windows documentação) antes de SetupDiCreateDeviceInterfaceRegKey ser chamado.
O conjunto de informações do dispositivo especificado por DeviceInfoSet deve conter apenas elementos no computador local.
Observação
O cabeçalho setupapi.h define SetupDiCreateDeviceInterfaceRegKey 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. 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 |