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