Função RegOpenUserClassesRoot (winreg.h)

Artigo
03/08/2023

Recupera um identificador para a chave HKEY_CLASSES_ROOT para um usuário especificado. O usuário é identificado por um token de acesso. A chave retornada tem uma exibição do registro que mescla o conteúdo da chave HKEY_LOCAL_MACHINE\Software\Classes com o conteúdo das chaves Software\Classes no hive do registro do usuário. Para obter mais informações, consulte HKEY_CLASSES_ROOT Key.

Sintaxe

LSTATUS RegOpenUserClassesRoot(
  [in]  HANDLE hToken,
        DWORD  dwOptions,
  [in]  REGSAM samDesired,
  [out] PHKEY  phkResult
);

Parâmetros

[in] hToken

Um identificador para um token de acesso primário ou de representação que identifica o usuário de interesse. Esse pode ser um identificador de token retornado por uma chamada para funções LogonUser, CreateRestrictedToken, DuplicateToken, DuplicateTokenEx, OpenProcessToken ou OpenThreadToken .

O identificador deve ter acesso TOKEN_QUERY. Para obter mais informações, consulte Direitos de Acesso para objetos Access-Token.

dwOptions

Esse parâmetro é reservado e precisa ser zero.

[in] samDesired

Uma máscara que especifica os direitos de acesso desejados para a chave. A função falhará se o descritor de segurança da chave não permitir o acesso solicitado para o processo de chamada. Para obter mais informações, consulte Segurança de Chave do Registro e Direitos de Acesso.

[out] phkResult

Um ponteiro para uma variável que recebe um identificador para a chave aberta. Quando você não precisar mais do identificador retornado, chame a função RegCloseKey para fechá-la.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor de retorno será o código de erro diferente de zero definido em Winerror.h. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma descrição genérica do erro.

Comentários

A função RegOpenUserClassesRoot permite recuperar as informações de HKEY_CLASSES_ROOT mescladas para usuários diferentes do usuário interativo. Por exemplo, o componente de servidor de um aplicativo cliente/servidor poderia usar RegOpenUserClassesRoot para recuperar as informações mescladas de um cliente.

RegOpenUserClassesRoot falhará se o perfil de usuário do usuário especificado não estiver carregado. Quando um usuário faz logon interativamente, o sistema carrega automaticamente o perfil do usuário. Para outros usuários, você pode chamar a função LoadUserProfile para carregar o perfil do usuário. No entanto, LoadUserProfile pode ser muito demorado, portanto, não chame-o para essa finalidade, a menos que seja absolutamente necessário ter as informações de HKEY_CLASSES_ROOT mescladas do usuário.

Os aplicativos em execução no contexto de segurança do usuário conectado interativamente não precisam usar RegOpenUserClassesRoot. Esses aplicativos podem chamar a função RegOpenKeyEx para recuperar uma exibição mesclada da chave HKEY_CLASSES_ROOT para o usuário interativo.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winreg.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll