Função SetupDiCreateDeviceInterfaceRegKeyW (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 SetupDiCreateDeviceInterfaceRegKeyW(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired,
[in, optional] HINF InfHandle,
[in, optional] PCWSTR 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 de 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 à segurança do Registro do tipo REGSAM, consulte a documentação do SDK do Microsoft Windows.
[in, optional] InfHandle
O identificador de 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 DDInstall
Valor de retorno
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.
Observações
O chamador dessa função deve ser um 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 de registro nãovolatile para a interface do dispositivo especificada. Os chamadores dessa função podem armazenar dados de configuração privados para a interface do dispositivo nessa chave. O driver do dispositivo pode acessar essa chave usando
Feche o identificador retornado dessa função chamando RegCloseKey.
Para instalações que usam arquivos de layout (especificado pela entrada LayoutFile em uma seção de versão INF), o arquivo de layout deve ser aberto por uma chamada para SetupOpenAppendInfFile (descrito na documentação do SDK do Windows) antes de SetupDiCreateDeviceInterfaceRegKey for chamado.
O conjunto de informações do dispositivo especificado pelo DeviceInfoSet deve conter apenas elementos no computador local.
Nota
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. 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 |