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 |