Freigeben über

SHRegSetUSValueA-Funktion (shlwapi.h)

  • Artikel

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 mit Null beendete Zeichenfolge mit dem Namen des Unterschlüssels.

[in] pszValue

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des Werts angibt.

[in] dwType

Typ: DWORD-

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 mit Null beendete Zeichenfolge, die den wert enthält, der für den angegebenen Schlüssel festgelegt werden soll.

[in, optional] cbData

Typ: DWORD-

Länge der Zeichenfolge, auf die durch den pvData--Parameter verwiesen wird, einschließlich des endenden Nullzeichens in Byte.

[in, optional] dwFlags

Typ: DWORD-

Flags, die angeben, wo die Daten geschrieben werden sollen.

SHREGSET_HKCU

Schreibzugriff auf HKEY_CURRENT_USER, wenn leer.

SHREGSET_FORCE_HKCU

Schreiben in HKEY_CURRENT_USER.

SHREGSET_HKLM

Schreibzugriff auf 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 ERROR_SUCCESS zurück, wenn dies erfolgreich ist, oder wenn der Fehlercode nicht in Winerror.h definiert ist. Sie können die FormatMessage--Funktion mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Bemerkungen

Diese Funktion öffnet den Schlüssel bei jeder Verwendung. Wenn Ihr Code das Festlegen einer Reihe von Werten im selben Schlüssel erfordert, ist es effizienter, den Schlüssel einmal mit SHRegOpenUSKey- zu öffnen und dann SHRegWriteUSValue zum Schreiben der Daten zu verwenden.

Anmerkung

Der Header "shlwapi.h" 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
mindestens unterstützte Client- Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- shlwapi.h
Library Shlwapi.lib
DLL- Shlwapi.dll (Version 4.71 oder höher)