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 |