ORSetValue 函数

设置脱机注册表配置单元中指定注册表项的值的数据。

语法

DWORD ORSetValue(
  _In_     ORHKEY Handle,
  _In_opt_ PCWSTR lpValueName,
  _In_     DWORD  dwType,
  _In_opt_ const BYTE *lpData,
  _In_     DWORD  cbData
);

参数

句柄 [in]

脱机注册表配置单元中打开的注册表项的句柄。

lpValueName [in， optional]

要设置的值的名称。 如果键中尚不存在具有此名称的值，则函数将其添加到键中。

如果 lpValueName 为 NULL 或空字符串“”，则函数将设置键的未命名值或默认值的类型和数据。

有关详细信息，请参阅 注册表元素大小限制。

注册表项没有默认值，但它们可以有一个未命名的值，可以是任何类型的值。

dwType [in]

lpData 参数指向的数据类型。 有关可能类型的列表，请参阅 注册表值类型。

lpData [in， 可选]

要存储的数据。

对于基于字符串的类型（例如REG_SZ），字符串必须以 null 结尾。 对于REG_MULTI_SZ数据类型，字符串必须以两个 null 字符结尾。

cbData [in]

lpData 参数指向的信息的大小（以字节为单位）。 如果数据的类型为 REG_SZ、REG_EXPAND_SZ 或 REG_MULTI_SZ， 则 cbData 必须包含终止 null 字符的大小。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值为 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与 FORMAT_MESSAGE_FROM_SYSTEM 标志一起使用，以获取错误的泛型说明。

备注

值大小受可用内存限制。 (超过 2048 字节的长值) 应存储为文件名存储在注册表中的文件。 这有助于注册表高效执行。 应用程序元素（如图标、位图和可执行文件）应存储为文件，而不是放在注册表中。

要求

要求	值
可再发行组件	Windows 脱机注册表库版本 1.0 或更高版本
标头	Offreg.h
DLL	Offreg.dll

另请参阅

ORCreateKey

OROpenKey