ResUtilFindSzProperty 函数 (resapi.h)

项目
08/25/2023

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

语法

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

parameters

[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	指定的属性无法在属性列表中找到。

注解

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

要求


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