RegSetKeyValueA-Funktion (winreg.h)

  • Artikel

Legt die Daten für den angegebenen Wert im angegebenen Registrierungsschlüssel und Unterschlüssel fest.

Syntax

LSTATUS RegSetKeyValueA(
  [in]           HKEY    hKey,
  [in, optional] LPCSTR  lpSubKey,
  [in, optional] LPCSTR  lpValueName,
  [in]           DWORD   dwType,
  [in, optional] LPCVOID lpData,
  [in]           DWORD   cbData
);

Parameter

[in] hKey

Ein Handle für einen geöffneten Registrierungsschlüssel. Der Schlüssel muss mit dem zugriffsrecht KEY_SET_VALUE geöffnet worden sein. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

Dieses Handle wird von der RegCreateKeyEx-, RegCreateKeyTransacted-, RegOpenKeyEx- oder RegOpenKeyTransacted-Funktion zurückgegeben. Es kann auch einer der folgenden vordefinierten Schlüssel sein:


   HKEY_CLASSES_ROOT
   HKEY_CURRENT_CONFIG
   HKEY_CURRENT_USER
   HKEY_LOCAL_MACHINE
   HKEY_USERS

[in, optional] lpSubKey

Der Name des Unterschlüssels relativ zum durch hKey identifizierten Schlüssel. Wenn der Unterschlüssel nicht vorhanden ist, wird er als nicht flüchtiger Schlüssel mit einer Standardsicherheitsbeschreibung erstellt. Wenn dieser Parameter NULL ist, wird der Wert in dem von hKey angegebenen Schlüssel erstellt.

[in, optional] lpValueName

Der Name des Registrierungswerts, dessen Daten aktualisiert werden sollen.

[in] dwType

Der Datentyp, auf den der lpData-Parameter verweist. Eine Liste der möglichen Typen finden Sie unter Registrierungswerttypen.

[in, optional] lpData

Die Daten, die mit dem angegebenen Wertnamen gespeichert werden sollen.

Für Zeichenfolgenbasierte Typen, z. B. REG_SZ, muss die Zeichenfolge null-beendet sein. Beim REG_MULTI_SZ Datentyp muss die Zeichenfolge mit zwei NULL-Zeichen beendet werden.

[in] cbData

Die Größe der Informationen, auf die der lpData-Parameter in Bytes verweist. Wenn die Daten vom Typ REG_SZ, REG_EXPAND_SZ oder REG_MULTI_SZ sind, muss cbData die Größe des beendenden NULL-Zeichens enthalten.

Rückgabewert

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

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

Hinweise

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Hinweis

Der winreg.h-Header definiert RegSetKeyValue 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 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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winreg.h (einschließlich Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

RegDeleteKeyValue

Registrierungsfunktionen