SHRegSetUSValueA-Funktion (shlwapi.h)
Legt einen Registrierungsunterschlüsselwert in einer benutzerspezifischen Unterstruktur (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE) fest.
Syntax
LSTATUS SHRegSetUSValueA(
[in] LPCSTR pszSubKey,
[in] LPCSTR pszValue,
[in] DWORD dwType,
[in, optional] const void *pvData,
[in, optional] DWORD cbData,
[in, optional] DWORD dwFlags
);
Parameter
[in] pszSubKey
Typ: LPCTSTR
Ein Zeiger auf eine NULL-endende Zeichenfolge mit dem Namen des Unterschlüssels.
[in] pszValue
Typ: LPCTSTR
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Werts angibt.
[in] dwType
Art: DWORD
Der Typ der zu speichernden Daten. Dieser Parameter muss der REG_SZ Typ sein. Weitere Informationen finden Sie unter Registrierungsdatentypen.
[in, optional] pvData
Typ: LPVOID*
Apointer auf eine NULL-endende Zeichenfolge, die den Wert enthält, der für den angegebenen Schlüssel festgelegt werden soll.
[in, optional] cbData
Art: DWORD
Länge der Zeichenfolge in Byte, auf die der pvData-Parameter verweist, ohne das abschließende NULL-Zeichen.
[in, optional] dwFlags
Art: DWORD
Flags, die angeben, wo die Daten geschrieben werden sollen.
SHREGSET_HKCU
Schreiben Sie in HKEY_CURRENT_USER , wenn leer.
SHREGSET_FORCE_HKCU
Schreiben in HKEY_CURRENT_USER.
SHREGSET_HKLM
Schreiben sie in HKEY_LOCAL_MACHINE , wenn leer.
SHREGSET_FORCE_HKLM
Schreiben in HKEY_LOCAL_MACHINE.
SHREGSET_DEFAULT
Entspricht (SHREGSET_FORCE_HKCU | SHREGSET_HKLM).
Rückgabewert
Typ: LSTATUS
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen in Winerror.h definierten Fehlercode ungleich null zurück. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Hinweise
Diese Funktion öffnet den Schlüssel bei jeder Verwendung. Wenn in Ihrem Code eine Reihe von Werten im gleichen Schlüssel festgelegt wird, ist es effizienter, den Schlüssel einmal mit SHRegOpenUSKey zu öffnen und dann SHRegWriteUSValue zu verwenden, um die Daten zu schreiben.
Hinweis
Der shlwapi.h-Header definiert SHRegSetUSValue als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
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