Funzione RegOpenCurrentUser (winreg.h)
Recupera un handle nella chiave HKEY_CURRENT_USER per l'utente che rappresenta il thread corrente.
Sintassi
LSTATUS RegOpenCurrentUser(
[in] REGSAM samDesired,
[out] PHKEY phkResult
);
Parametri
[in] samDesired
Maschera che specifica i diritti di accesso desiderati alla chiave. La funzione ha esito negativo se il descrittore di sicurezza della chiave non consente l'accesso richiesto per il processo di chiamata. Per altre informazioni, vedere Sicurezza delle chiavi del Registro di sistema e diritti di accesso.
[out] phkResult
Puntatore a una variabile che riceve un handle per la chiave aperta. Quando non è più necessario l'handle restituito, chiamare la funzione RegCloseKey per chiuderla.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere una descrizione generica dell'errore.
Commenti
La chiave HKEY_CURRENT_USER esegue il mapping alla radice del ramo dell'utente corrente nella chiave HKEY_USERS . Viene memorizzato nella cache per tutti i thread in un processo. Pertanto, questo valore non cambia quando viene caricato il profilo di un altro utente. RegOpenCurrentUser usa il token del thread per accedere alla chiave appropriata o il valore predefinito se il profilo non viene caricato.
Requisiti
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | winreg.h (include Windows.h) |
Libreria | Advapi32.lib |
DLL | Advapi32.dll |