ResUtilGetBinaryValue 函数 (resapi.h)

群集数据库返回二进制值。

语法

DWORD ResUtilGetBinaryValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPBYTE  *ppbOutValue,
  [out]           LPDWORD pcbOutValueSize
);

参数

[in] hkeyClusterKey

群集数据库中标识要检索的值的位置的键。

[in] pszValueName

指向以 null 结尾的 Unicode 字符串的指针,该字符串包含要检索的值的名称。

[out, optional] ppbOutValue

指向检索到的值的指针的地址。

[out] pcbOutValueSize

指向 DWORD 的指针,其中返回 ppbOutValue 指向的缓冲区的大小(以字节为单位)。

返回值

如果操作成功,函数将返回 ERROR_SUCCESS

如果操作失败,函数将返回 系统错误代码。 下面是可能的错误代码。

返回代码 说明
ERROR_NOT_ENOUGH_MEMORY
为值分配内存时出错。

注解

ResUtilGetBinaryValue 实用工具函数负责为值分配必要的内存,然后调用 Cluster API 函数 ClusterRegQueryValue。 完成分配的内存后,必须调用 函数 LocalFree 才能释放它。

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 企业版、Windows Server 2008 Datacenter
目标平台 Windows
标头 resapi.h
Library ResUtils.lib
DLL ResUtils.dll

另请参阅

ClusterRegQueryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetMultiSzValue

ResUtilGetSzValue