Função SetupDiOpenClassRegKeyExA (setupapi.h)
A função SetupDiOpenClassRegKeyEx abre a classe de instalação do dispositivo chave do Registro, a classe de interface do dispositivo chave do Registro ou a subchave de uma classe específica. Essa função abre a chave especificada no computador local ou em um computador remoto.
Sintaxe
WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired,
[in] DWORD Flags,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parâmetros
[in, optional] ClassGuid
Um ponteiro para o GUID da classe cuja chave do Registro deve ser aberta. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for NULL, a raiz da árvore de classe (HKLM\SYSTEM\CurrentControlSet\Control\Class) será aberta.
[in] samDesired
O acesso de segurança do Registro para a chave a ser aberta. 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] Flags
O tipo de chave do Registro a ser aberta, que é especificado por um dos seguintes:
DIOCR_INSTALLER
Abra uma chave de classe de configuração. Se ClassGuid for NULL, abra a chave raiz do branch do instalador de classe.
DIOCR_INTERFACE
Abra uma chave de classe de interface. Se ClassGuid for NULL, abra a chave raiz do branch de classe de interface.
[in, optional] MachineName
Opcionalmente, aponta para uma cadeia de caracteres que contém o nome de um computador remoto no qual abrir a chave especificada.
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
Reservado. Deve ser NULL.
Valor de retorno
SetupDiOpenClassRegKeyEx retorna um identificador para uma chave de registro aberta em que as informações sobre essa classe de instalação podem ser armazenadas/recuperadas.
Se a função falhar, ela retornará INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame GetLastError.
Observações
Dependendo do valor passado no parâmetro samDesired, pode ser necessário que o chamador dessa função seja membro do grupo Administradores.
SetupDiOpenClassRegKeyEx não criará uma chave do Registro se ela ainda não existir.
Os chamadores dessa função devem fechar o identificador retornado dessa função chamando RegCloseKey.
Nota
O cabeçalho setupapi.h define SetupDiOpenClassRegKeyEx 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 |