通过

SHSetValueW 函数 （shlwapi.h）

  • 项目

设置注册表项的值。

语法

LSTATUS SHSetValueW(
  [in]           HKEY    hkey,
  [in, optional] LPCWSTR pszSubKey,
  [in, optional] LPCWSTR pszValue,
  [in]           DWORD   dwType,
  [in, optional] LPCVOID pvData,
  [in]           DWORD   cbData
);

参数

[in] hkey

类型：HKEY

当前打开的键或任何以下预定义值的句柄。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in, optional] pszSubKey

类型：LPCTSTR

以 null 结尾的字符串的地址，该字符串指定与值关联的子项的名称。 这可以 NULL 或指向空字符串的指针。 在这种情况下，该值将添加到由 hkey 参数标识的键中。

[in, optional] pszValue

类型：LPCTSTR

指定值的 null 终止字符串的地址。 此值可以 NULL。

[in] dwType

类型：DWORD

要存储的数据的类型。 此参数必须是 REG_SZ 类型。 有关详细信息，请参阅 注册表数据类型。

[in, optional] pvData

类型：LPCVOID

指向包含为指定值设置的数据的缓冲区的指针。 此值可以 NULL。

[in] cbData

类型：DWORD

pvData 参数指向的缓冲区的长度（以字节为单位）。 如果数据是以 null 结尾的字符串，则此长度包括终止 null 字符。

返回值

类型：LSTATUS

如果成功，则返回ERROR_SUCCESS;否则，在 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与FORMAT_MESSAGE_FROM_SYSTEM标志一起使用来检索错误的泛型说明。

言论

注意

shlwapi.h 标头将 SHSetValue 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional、Windows XP [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 shlwapi.h
库 Shlwapi.lib
DLL Shlwapi.dll（版本 4.71 或更高版本）