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 |