ResUtilGetSzProperty 函数 (resapi.h)

从属性 列表中 检索字符串属性,并将指针前进到列表中的下一个属性。 PRESUTIL_GET_SZ_PROPERTY类型定义指向此函数的指针。

语法

DWORD ResUtilGetSzProperty(
  [out]          LPWSTR             *ppszOutValue,
  [in]           const PCLUSPROP_SZ pValueStruct,
  [in, optional] LPCWSTR            pszOldValue,
  [in, out]      LPBYTE             *ppPropertyList,
  [in, out]      LPDWORD            pcbPropertyListSize
);

parameters

[out] ppszOutValue

将在其中返回属性列表中的字符串值的指针的地址。

[in] pValueStruct

指向 CLUSPROP_SZ 结构的指针,该结构指定要从属性列表中检索的字符串值。

[in, optional] pszOldValue

指向 属性上一个值的指针。

[in, out] ppPropertyList

指向包含字符串属性的属性列表缓冲区的指针的地址。 此指针将前进到下一个属性的开头。

[in, out] pcbPropertyListSize

指向属性列表缓冲区大小的指针。 大小将递减,以考虑 ppPropertyList 指针的推进。

返回值

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

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

返回代码 说明
ERROR_INVALID_PARAMETER
数据的格式不正确。

要求

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

请参阅

ResUtilGetBinaryProperty

ResUtilGetDwordProperty

ResUtilGetMultiSzProperty