Función RegOpenCurrentUser (winreg.h)

  • Artículo

Recupera un identificador de la clave de HKEY_CURRENT_USER para el usuario que suplanta el subproceso actual.

Sintaxis

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

Parámetros

[in] samDesired

Máscara que especifica los derechos de acceso deseados a la clave. Se produce un error en la función si el descriptor de seguridad de la clave no permite el acceso solicitado para el proceso de llamada. Para obtener más información, consulte Derechos de acceso y seguridad de clave del Registro.

[out] phkResult

Puntero a una variable que recibe un identificador de la clave abierta. Cuando ya no necesite el identificador devuelto, llame a la función RegCloseKey para cerrarlo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si la función no se ejecuta correctamente, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error.

Comentarios

La clave HKEY_CURRENT_USER se asigna a la raíz de la rama del usuario actual en la clave HKEY_USERS . Se almacena en caché para todos los subprocesos de un proceso. Por lo tanto, este valor no cambia cuando se carga el perfil de otro usuario. RegOpenCurrentUser usa el token del subproceso para acceder a la clave adecuada o el valor predeterminado si el perfil no se carga.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winreg.h (incluya Windows.h)
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

RegCloseKey

Funciones del Registro

Introducción al Registro