ORSetValue-Funktion
Legt die Daten für den Wert eines angegebenen Registrierungsschlüssels in einer Offlineregistrierungsstruktur fest.
Syntax
DWORD ORSetValue(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpValueName,
_In_ DWORD dwType,
_In_opt_ const BYTE *lpData,
_In_ DWORD cbData
);
Parameter
-
Handle [in]
-
Ein Handle für einen geöffneten Registrierungsschlüssel in einer Offlineregistrierungsstruktur.
-
lpValueName [in, optional]
-
Der Name des festzulegenden Werts. Wenn ein Wert mit diesem Namen noch nicht im Schlüssel vorhanden ist, fügt die Funktion ihn dem Schlüssel hinzu.
Wenn lpValueNameNULL oder eine leere Zeichenfolge ist, legt die Funktion den Typ und die Daten für den unbenannten oder Standardwert des Schlüssels fest.
Weitere Informationen finden Sie unter Größenbeschränkungen für Registrierungselemente.
Registrierungsschlüssel haben keine Standardwerte, aber sie können einen unbenannten Wert haben, der von einem beliebigen Typ sein kann.
-
dwType [in]
-
Der Datentyp, auf den der lpData-Parameter verweist. Eine Liste der möglichen Typen finden Sie unter Registrierungswerttypen.
-
lpData [in, optional]
-
Die zu speichernden Daten.
Bei zeichenfolgenbasierten Typen, z. B. REG_SZ, muss die Zeichenfolge NULL-endend sein. Für den Datentyp REG_MULTI_SZ muss die Zeichenfolge mit zwei NULL-Zeichen beendet werden.
-
cbData [in]
-
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 oder der abschließenden NULL-Zeichen enthalten.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein in Winerror.h definierter Fehlercode ungleich null. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.
Bemerkungen
Die Wertgrößen werden durch den verfügbaren Arbeitsspeicher begrenzt. Lange Werte (mehr als 2048 Bytes) sollten als Dateien mit den in der Registrierung gespeicherten Dateinamen gespeichert werden. Dadurch kann die Registrierung effizient ausgeführt werden. Anwendungselemente wie Symbole, Bitmaps und ausführbare Dateien sollten als Dateien gespeichert und nicht in der Registrierung platziert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Verteilbare Komponente |
Windows-Offlineregistrierungsbibliothek, Version 1.0 oder höher |
| Header |
|
| DLL |
|
Siehe auch