Fonction RegOpenCurrentUser (winreg.h)
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 |