Funzione RegOpenCurrentUser (winreg.h)

  • Articolo

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

Vedi anche

Regclosekey

Funzioni del Registro di sistema

Panoramica del Registro di sistema