ResUtilFindBinaryProperty 函数 (resapi.h)

项目
03/01/2024

在属性列表中查找指定的二进制属性，还可以返回该属性的值。 PRESUTIL_FIND_BINARY_PROPERTY类型定义指向此函数的指针。

语法

DWORD ResUtilFindBinaryProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPBYTE      *pbPropertyValue,
  [out, optional] LPDWORD     pcbPropertyValueSize
);

参数

[in] pPropertyList

指向要在其中查找值的属性列表的指针。

[in] cbPropertyListSize

pPropertyList 指定的属性列表的大小（以字节为单位）。

[in] pszPropertyName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要查找的属性的名称。

[out, optional] pbPropertyValue

指向包含属性值副本的函数分配 (缓冲区) 的 BYTE 指针的指针。必须在 *pbPropertyValue) 上调用 LocalFree (才能释放分配的内存。如果不需要任何值，请为此参数传递 NULL 。

[out, optional] pcbPropertyValueSize

指向返回的值的大小（以字节为单位）的指针。如果不需要大小，请为此参数传递 NULL 。

返回值

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

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

返回代码	说明
ERROR_INVALID_DATA	属性列表的格式不正确。
ERROR_NOT_ENOUGH_MEMORY	函数无法分配要在其中返回属性值的缓冲区。
ERROR_FILE_NOT_FOUND	指定的属性无法在属性列表中找到。

注解

如果 ResUtilFindBinaryProperty 成功，则 *pbPropertyValue 指向 pPropertyList 中存储的数据的副本。请务必在 *pbPropertyValue 上调用 LocalFree，以防止内存泄漏。

要求

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