ResUtilFindLongProperty 函数 (resapi.h)

项目
03/01/2024

在属性列表中查找有符号的 long 属性值。 PRESUTIL_FIND_LONG_PROPERTY类型定义指向此函数的指针。

语法

DWORD ResUtilFindLongProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPLONG      plPropertyValue
);

参数

[in] pPropertyList

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

[in] cbPropertyListSize

pPropertyList 中包含的数据的大小（以字节为单位）。

[in] pszPropertyName

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

[out] plPropertyValue

指向属性列表缓冲区中存储的数据的实际值的指针。

返回值

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

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

返回代码	说明
ERROR_INVALID_DATA	数据的格式不正确。
ERROR_FILE_NOT_FOUND	属性无法位于属性列表中。

注解

如果操作成功， 则 plPropertyValue 直接指向属性列表缓冲区。使用 plPropertyValue 时，请注意不要干扰属性列表的格式设置。

要求

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