Função SetupDiOpenClassRegKey (setupapi.h)
A função SetupDiOpenClassRegKey abre a chave do Registro da classe de instalação ou a subchave de uma classe específica.
Sintaxe
WINSETUPAPI HKEY SetupDiOpenClassRegKey(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired
);
Parâmetros
[in, optional] ClassGuid
Um ponteiro para o GUID da classe de configuração cuja chave deve ser aberta. Esse parâmetro é opcional e pode ser NULL. Se esse parâmetro for NULL, a raiz da árvore de classes de instalação (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 de segurança do Registro do tipo REGSAM, consulte a documentação do SDK do Microsoft Windows.
Retornar valor
Se a função for bem-sucedida, ela retornará um identificador para uma chave do 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.
Comentários
Dependendo do valor passado no parâmetro samDesired , pode ser necessário que o chamador dessa função seja membro do grupo Administradores.
Essa função não criará uma chave do Registro se ela ainda não existir.
O identificador retornado dessa função deve ser fechado chamando RegCloseKey.
Para abrir a chave do Registro da classe de interface ou uma subchave de classe de interface específica, chame SetupDiOpenClassRegKeyEx.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | DesktopPara universal, chame CM_Open_Class_Key |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |