Função SetupDiOpenClassRegKey (setupapi.h)

  • Artigo

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

Confira também

SetupDiOpenClassRegKeyEx

SetupDiOpenDevRegKey