IPropertyStorage：：ReadPropertyNames 方法 (propidlbase.h)

  • 项目

ReadPropertyNames 方法检索指定属性 ID 的任何现有字符串名称。

语法

HRESULT ReadPropertyNames(
  [in]      ULONG           cpropid,
  [in]      const PROPID [] rgpropid,
  [in, out] LPOLESTR []     rglpwstrName
);

parameters

[in] cpropid

数组 rgpropid 的输入上的元素数。 此参数的值可以设置为零，但是，这会破坏此方法的用途，因为不会因此读取任何属性名称。

[in] rgpropid

要检索其名称的属性 ID 数组。

[in, out] rglpwstrName

调用方分配的 LPWSTR 成员的大小 cpropid 数组。 返回时，实现将填充此数组。 给定条目包含属性 ID 的相应字符串名称，如果属性 ID 没有字符串名称，则可为空。

应使用 CoTaskMemFree 函数释放数组的每个 LPWSTR 成员。

返回值

此方法支持E_UNEXPECTED的标准返回值，此外还支持以下各项：

注解

对于 rgpropid 数组中提供的属性 ID 列表中的每个属性 ID， ReadPropertyNames 将检索相应的字符串名称（如果有）。 可以通过在创建属性时在调用 IPropertyStorage：：WriteMultiple 时指定名称，或通过调用 IPropertyStorage：：WritePropertyNames 来创建字符串名称。 在任一情况下，字符串名称都是可选的，但所有属性都必须具有属性 ID。

映射到属性 ID 的字符串名称在集中必须是唯一的。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 propidlbase.h (包括 Objbase.h、Propidlbase.h)
Library Uuid.lib
DLL Ole32.dll

请参阅

IPropertyStorage

IPropertyStorage：：WriteMultiple

IPropertyStorage：：WritePropertyNames