Compartilhar via


Função RegOpenCurrentUser (winreg.h)

Recupera um identificador para a chave HKEY_CURRENT_USER para o usuário que o thread atual está representando.

Sintaxe

LSTATUS RegOpenCurrentUser(
  [in]  REGSAM samDesired,
  [out] PHKEY  phkResult
);

Parâmetros

[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 chave HKEY_CURRENT_USER é mapeada para a raiz do branch do usuário atual na chave HKEY_USERS . Ele é armazenado em cache para todos os threads em um processo. Portanto, esse valor não é alterado quando o perfil de outro usuário é carregado. RegOpenCurrentUser usa o token do thread para acessar a chave apropriada ou o padrão se o perfil não for carregado.

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

Confira também

Regclosekey

Funções do Registro

Visão geral do Registro