ResUtilFindExpandSzProperty 函数 (resapi.h)

项目
03/01/2024

在属性列表中查找可展开的字符串属性。 PRESUTIL_FIND_EXPAND_SZ_PROPERTY类型定义指向此函数的指针。

语法

DWORD ResUtilFindExpandSzProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPWSTR      *pszPropertyValue
);

参数

[in] pPropertyList

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

[in] cbPropertyListSize

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

[in] pszPropertyName

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

[out, optional] pszPropertyValue

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

返回值

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

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

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

注解

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

要求

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