SHRegOpenUSKeyA-Funktion (shlwapi.h)
Öffnet einen Registrierungsunterschlüssel in einer benutzerspezifischen Unterstruktur (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE).
Syntax
LSTATUS SHRegOpenUSKeyA(
[in] LPCSTR pszPath,
[in] REGSAM samDesired,
[in, optional] HUSKEY hRelativeUSKey,
[out] PHUSKEY phNewUSKey,
[in] BOOL fIgnoreHKCU
);
Parameter
[in] pszPath
Typ: LPCTSTR
Ein Zeiger auf eine NULL-Zeichenfolge mit dem Namen des Unterschlüssels.
[in] samDesired
Typ: REGSAM
Der gewünschte Sicherheitszugriff. Weitere Informationen zum Sicherheitszugriff finden Sie unter REGSAM.
[in, optional] hRelativeUSKey
Typ: HUSKEY
Der Schlüssel, der als Basis für relative Pfade verwendet werden soll. Wenn es sich bei pszPath um einen relativen Pfad handelt, ist der von diesem angegeben Schlüssel relativ zu hRelativeUSKey. Wenn pszPath ein absoluter Pfad ist, legen Sie hRelativeUSKey auf NULL fest.
[out] phNewUSKey
Typ: PHUSKEY
Ein Zeiger auf das Handle des geöffneten Schlüssels.
[in] fIgnoreHKCU
Typ: BOOL
Die Variable, die angibt, unter welchen Schlüssel gesucht werden soll. Bei Festlegung auf TRUE ignoriert SHRegOpenUSKeyHKEY_CURRENT_USER und gibt einen Wert von HKEY_LOCAL_MACHINE zurück.
Rückgabewert
Typ: LSTATUS
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen in Winerror.h definierten Nonzero-Fehlercode zurück. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Hinweise
Hinweis
Der shlwapi.h-Header definiert SHRegOpenUSKey als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlwapi.h |
Bibliothek | Shlwapi.lib |
DLL | Shlwapi.dll (Version 4.71 oder höher) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für