ResUtilSetMultiSzValue 函数 (resapi.h)
在 群集数据库中设置多个字符串值。 PRESUTIL_SET_MULTI_SZ_VALUE类型定义指向此函数的指针。
语法
DWORD ResUtilSetMultiSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] LPCWSTR pszNewValue,
[in] DWORD cbNewValueSize,
[out, optional] LPWSTR *ppszOutValue,
[in, out, optional] LPDWORD pcbOutValueSize
);
参数
[in] hkeyClusterKey
标识群集数据库中多个字符串值的位置的键。
[in] pszValueName
以 Null 结尾的 Unicode 字符串，其中包含要更新的值的名称。
[in] pszNewValue
指向新的多个字符串值的指针。
[in] cbNewValueSize
新值的大小。
[out, optional] ppszOutValue
指向接收已更新值副本的字符串指针的指针。 如果使用，调用方必须在 *ppszOutValue 上调用 LocalFree。
[in, out, optional] pcbOutValueSize
接收新值大小的指针。
返回值
如果操作成功，函数将返回 ERROR_SUCCESS。
如果操作失败，该函数将返回 系统错误代码。 下面是可能的错误代码。
| 返回代码 | 说明 |
|---|---|
|
尝试分配内存时出错。 |
注解
ResUtilSetMultiSzValue 实用工具函数为新值分配内存，并调用 Cluster API 函数 ClusterRegSetValue。
多字符串值是一个大字符串，其中包含较小、连续的、以 null 结尾的 Unicode 字符串，并在最后一个字符串后以额外的 null 字符结尾。
请务必在 *ppszOutValue 上调用 LocalFree，以避免内存泄漏。
不要从以下资源 DLL 入口点函数调用 ResUtilSetMultiSzValue ：
可以从任何其他资源 DLL 入口点函数或工作线程安全地调用 ResUtilSetMultiSzValue。 有关详细信息，请参阅 在资源 DLL 中对避免的函数调用。要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目标平台 | Windows |
| 标头 | resapi.h |
| Library | ResUtils.lib |
| DLL | ResUtils.dll |