RegSetValueA-Funktion (winreg.h)
Legt die Daten für den Standard- oder unbenannten Wert eines angegebenen Registrierungsschlüssels fest. Die Daten müssen eine Textzeichenfolge sein.
Syntax
LSTATUS RegSetValueA(
[in] HKEY hKey,
[in, optional] LPCSTR lpSubKey,
[in] DWORD dwType,
[in] LPCSTR 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 eines Unterschlüssels des hKey-Parameters . Die Funktion legt den Standardwert des angegebenen Unterschlüssels fest. Wenn lpSubKey nicht vorhanden ist, wird es von der Funktion erstellt.
Bei Schlüsselnamen wird die Groß-/Kleinschreibung nicht beachtet.
Wenn dieser Parameter NULL ist oder auf eine leere Zeichenfolge verweist, legt die Funktion den Standardwert des durch hKey identifizierten Schlüssels fest.
Weitere Informationen finden Sie unter Größenbeschränkungen für Registrierungselemente.
[in] dwType
Der Typ der zu speichernden Informationen. Dieser Parameter muss der REG_SZ-Typ sein. Verwenden Sie zum Speichern anderer Datentypen die RegSetValueEx-Funktion .
[in] lpData
Die zu speichernden Daten. Dieser Parameter darf nicht NULL sein.
[in] cbData
Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen. Die Funktion berechnet diesen Wert basierend auf der Größe der Daten im lpData-Parameter .
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
Wenn der durch den lpSubKey-Parameter angegebene Schlüssel nicht vorhanden ist, wird er von der RegSetValue-Funktion erstellt.
Wenn die ANSI-Version dieser Funktion verwendet wird (entweder durch explizites Aufrufen von RegSetValueA oder durch Nichtdefinition von UNICODE, bevor die Windows.h-Datei eingeschlossen wird), muss der lpData-Parameter eine ANSI-Zeichenfolge sein. Die Zeichenfolge wird in Unicode konvertiert, bevor sie in der Registrierung gespeichert wird.
Hinweis
Der winreg.h-Header definiert RegSetValue 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 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winreg.h (einschließlich Windows.h) |
Bibliothek | Advapi32.lib |
DLL | Advapi32.dll |