Freigeben über


RegOpenCurrentUser-Funktion (winreg.h)

Ruft ein Handle für den HKEY_CURRENT_USER Schlüssel für den Benutzer ab, den der aktuelle Thread imitiert.

Syntax

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

Parameter

[in] samDesired

Eine Maske, die die gewünschten Zugriffsrechte für den Schlüssel angibt. Die Funktion schlägt fehl, wenn der Sicherheitsdeskriptor des Schlüssels den angeforderten Zugriff für den aufrufenden Prozess nicht zulässt. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

[out] phkResult

Ein Zeiger auf eine Variable, die ein Handle für den geöffneten Schlüssel empfängt. Wenn Sie das zurückgegebene Handle nicht mehr benötigen, rufen Sie die RegCloseKey-Funktion auf, um es zu schließen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in Winerror.h definierter Fehlercode ungleich null. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Hinweise

Der HKEY_CURRENT_USER Schlüssel wird dem Stamm des Branchs des aktuellen Benutzers im HKEY_USERS Schlüssel zugeordnet. Es wird für alle Threads in einem Prozess zwischengespeichert. Daher ändert sich dieser Wert nicht, wenn das Profil eines anderen Benutzers geladen wird. RegOpenCurrentUser verwendet das Token des Threads, um auf den entsprechenden Schlüssel zuzugreifen, oder die Standardeinstellung, wenn das Profil nicht geladen wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winreg.h (Windows.h einschließen)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

RegCloseKey

Registrierungsfunktionen

Übersicht über die Registrierung