Fonction RegOpenCurrentUser (winreg.h)

  • Article

Récupère un handle à la clé HKEY_CURRENT_USER pour l’utilisateur que le thread actuel emprunte d’identité.

Syntaxe

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

Paramètres

[in] samDesired

Masque qui spécifie les droits d’accès souhaités à la clé. La fonction échoue si le descripteur de sécurité de la clé n’autorise pas l’accès demandé pour le processus appelant. Pour plus d’informations, consultez Sécurité de la clé de Registre et droits d’accès.

[out] phkResult

Pointeur vers une variable qui reçoit un handle vers la clé ouverte. Lorsque vous n’avez plus besoin du handle retourné, appelez la fonction RegCloseKey pour la fermer.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est un code d’erreur différent de zéro défini dans Winerror.h. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur.

Remarques

La clé HKEY_CURRENT_USER est mappée à la racine de la branche de l’utilisateur actuel dans la clé HKEY_USERS . Il est mis en cache pour tous les threads d’un processus. Par conséquent, cette valeur ne change pas lorsque le profil d’un autre utilisateur est chargé. RegOpenCurrentUser utilise le jeton du thread pour accéder à la clé appropriée, ou à la valeur par défaut si le profil n’est pas chargé.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winreg.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

RegCloseKey

Fonctions du Registre

Vue d’ensemble du Registre