iWMDMStorage4::GetSpecifiedMetadata 方法 (mswmdm.h)
GetSpecifiedMetadata 方法从存储中检索一个或多个特定的元数据属性。
语法
HRESULT GetSpecifiedMetadata(
[in] DWORD cProperties,
[in] LPCWSTR *ppwszPropNames,
[out] IWMDMMetaData **ppMetadata
);
参数
[in] cProperties
要检索的属性计数。
[in] ppwszPropNames
要检索的属性名称的数组。 此数组的长度应等于 cProperties。 应用程序应使用 CoTaskMemFree 释放此内存。
[out] ppMetadata
指向返回的 IWMDMMetaData 接口指针的指针,其中包含检索到的值。 调用方在使用完此接口后必须释放此接口。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
此方法使客户端可以控制检索哪些属性。 这比 IWMDMStorage3::GetMetadata 更有效,当客户端只需要存储支持的属性子集时,建议这样做。
如果使用此方法从 Windows 可移植设备 (WPD) 设备检索数据,则数据以二进制形式在 IPortableDeviceValues 对象中返回。 应用程序应取消序列化此数据,以获取实际属性值。
该方法成功并返回WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED即使某些指定的属性无法检索 (但至少) 检索了一个属性。 如果无法检索任何指定的属性,该方法将失败并返回WMDM_E_NOTSUPPORTED。
请求单个属性是此方法的一种特殊情况。 如果客户端请求单个属性,则可能的返回代码S_OK、E_INVALIDARG和WMDM_E_NOTSUPPORTED。 因此,对于单个属性,仅当成功检索属性时, 方法才会成功。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |