resUtilSetBinaryValue 函数 (resapi.h)
在 群集数据库中设置二进制值。
语法
DWORD ResUtilSetBinaryValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] const LPBYTE pbNewValue,
[in] DWORD cbNewValueSize,
[in, out, optional] LPBYTE *ppbOutValue,
[in, out] LPDWORD pcbOutValueSize
);
参数
[in] hkeyClusterKey
标识二进制值在群集数据库中的位置的键。
[in] pszValueName
一个以 null 结尾的 Unicode 字符串，其中包含要更新的值的名称。
[in] pbNewValue
指向新二进制值的指针。
[in] cbNewValueSize
新二进制值的大小。
[in, out, optional] ppbOutValue
指向新二进制值的指针的地址。
[in, out] pcbOutValueSize
指向 DWORD 的指针，其中返回 ppbOutValue 指向的值的大小（以字节为单位）。
返回值
如果操作成功，函数将返回 ERROR_SUCCESS。
如果操作失败，该函数将返回 系统错误代码。 下面是可能的错误代码。
| 返回代码 | 说明 |
|---|---|
|
内存分配期间出错。 |
注解
ResUtilSetBinaryValue 实用工具函数使用函数 LocalAlloc 为 ppbOutValue 指针分配内存，调用 Cluster API 函数 ClusterRegSetValue，然后将新值复制到此缓冲区。 如果指针不为 NULL，ResUtilSetBinaryValue 也会解除分配它。 作为此函数的调用方，你负责使用函数 LocalFree 解除分配缓冲区。
不要从以下资源 DLL 入口点函数调用 ResUtilSetBinaryValue ：
可以从任何其他资源 DLL 入口点函数或工作线程安全地调用 ResUtilSetBinaryValue。 有关详细信息，请参阅 在资源 DLL 中对避免的函数调用。要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目标平台 | Windows |
| 标头 | resapi.h |
| Library | ResUtils.lib |
| DLL | ResUtils.dll |