SHRegSetValue 函数 (shlwapi.h)

项目
03/02/2024

不支持。

设置注册表值。

使用 RegSetValue 代替它。

语法

LSTATUS SHRegSetValue(
  [in] HKEY    hkey,
  [in] LPCWSTR pszSubKey,
  [in] LPCWSTR pszValue,
  [in] SRRF    srrfFlags,
  [in] DWORD   dwType,
  [in] 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] pszSubKey

类型： LPCWSTR

指向以 null 结尾的字符串的指针，该字符串指定从 hkey 到从中检索值的子项的相对路径。此参数可以是 NULL 或空字符串，在这种情况下，将从 hkey 位置检索数据。

[in] pszValue

类型： LPCWSTR

指向包含值名称的以 null 结尾的字符串的指针。此参数可以是 NULL 或空字符串，在这种情况下，将从默认值检索数据。

[in] srrfFlags

类型： SRRF

限制要设置的数据的一个或多个 SRRF 标志。必须至少指定一个类型限制 (SRRF_RT) 值。

[in] dwType

类型：DWORD

指示要设置的值中存储的数据类型的 DWORD 。使用默认值时，输入 dwType 是默认值的类型。有关可能的值，请参阅注册表数据类型。如果未设置SRRF_NOEXPAND标志，则REG_EXPAND_SZ类型会自动展开并作为REG_SZ返回。如果不需要类型信息，则此参数可以为 NULL。

[in] pvData

类型： LPCVOID

指向包含值数据的缓冲区的指针。如果不需要数据，此参数可以为 NULL 。

[in] cbData

类型：DWORD

源数据缓冲区 pvData 的大小（以字节为单位）。仅当 pvData 为 NULL 时，此值才能为 NULL。

返回值

类型： LONG

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

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shlwapi.h (包括 Shlwapi.h)
DLL	Shlwapi.dll

另请参阅

RegSetKeyValue