shRegSetUSValueA 函数 (shlwapi.h)

在特定于用户的子树 (HKEY_CURRENT_USER 或HKEY_LOCAL_MACHINE) 中设置注册表子项值。

语法

LSTATUS SHRegSetUSValueA(
  [in]           LPCSTR     pszSubKey,
  [in]           LPCSTR     pszValue,
  [in]           DWORD      dwType,
  [in, optional] const void *pvData,
  [in, optional] DWORD      cbData,
  [in, optional] DWORD      dwFlags
);

参数

[in] pszSubKey

类型： LPCTSTR

指向以 null 结尾的字符串的指针，其中包含子项的名称。

[in] pszValue

类型： LPCTSTR

指向以 null 结尾的字符串的指针，该字符串指定值的名称。

[in] dwType

类型：DWORD

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

[in, optional] pvData

类型： LPVOID*

指向以 null 结尾的字符串的pointer，该字符串包含要为指定键设置的值。

[in, optional] cbData

类型：DWORD

pvData 参数指向的字符串的长度（以字节为单位），不包括终止 null 字符。

[in, optional] dwFlags

类型：DWORD

指示应写入数据的标志。

SHREGSET_HKCU

如果 为空， 则写入HKEY_CURRENT_USER。

SHREGSET_FORCE_HKCU

写入 HKEY_CURRENT_USER。

SHREGSET_HKLM

如果 为空， 则写入HKEY_LOCAL_MACHINE。

SHREGSET_FORCE_HKLM

写入 HKEY_LOCAL_MACHINE。

SHREGSET_DEFAULT

等效于 (SHREGSET_FORCE_HKCU | SHREGSET_HKLM) 。

返回值

类型： LSTATUS

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

注解

每次使用时，此函数都会打开密钥。 如果代码涉及在同一键中设置一系列值，则使用 SHRegOpenUSKey 打开密钥一次，然后使用 SHRegWriteUSValue 写入数据会更有效。

注意

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

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	shlwapi.h
Library	Shlwapi.lib
DLL	Shlwapi.dll (4.71 或更高版本)