IPropertyStorage::ReadPropertyNames 方法 (propidl.h)

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

语法

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

参数

[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
标头 propidl.h (包括 Objbase.h、Propidlbase.h)
Library Uuid.lib
DLL Ole32.dll

另请参阅

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames