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