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 设备管理器中的所有接口方法都可以返回以下任一类错误代码：

有关可能错误代码的广泛列表，请参阅错误代码。

此方法使客户端可以控制检索哪些属性。这比 IWMDMStorage3：：GetMetadata 更有效，当客户端只需要存储支持的属性子集时，建议这样做。

如果使用此方法从 Windows 可移植设备 (WPD) 设备检索数据，则数据以二进制形式在 IPortableDeviceValues 对象中返回。应用程序应取消序列化此数据，以获取实际属性值。

该方法成功并返回WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED即使某些指定的属性无法检索 (但至少) 检索了一个属性。如果无法检索任何指定的属性，该方法将失败并返回WMDM_E_NOTSUPPORTED。

请求单个属性是此方法的一种特殊情况。如果客户端请求单个属性，则可能的返回代码S_OK、E_INVALIDARG和WMDM_E_NOTSUPPORTED。因此，对于单个属性，仅当成功检索属性时，方法才会成功。