IMDSPStorage4：：GetSpecifiedMetadata 方法 (mswmdm.h)

GetSpecifiedMetadata 方法仅检索存储的指定元数据对象。

语法

HRESULT GetSpecifiedMetadata(
  [in]  DWORD         cProperties,
  [in]  LPCWSTR       *ppwszPropNames,
  [out] IWMDMMetaData *pMetadata
);

[in] cProperties

要检索的属性计数。

[in] ppwszPropNames

包含要检索的属性名称的数组。此数组的大小应等于 cProperties。

[out] pMetadata

指向返回的 IWMDMMetaData 接口指针的指针。

该方法返回 HRESULT。 Windows Media 设备管理器中的所有接口方法都可以返回以下任一类错误代码：

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

此方法使客户端可以控制检索哪些属性。客户端可以为客户端需要检索的属性指定属性名称。

相比之下， GetMetadata 方法检索) 属性 (所有存储元数据。

如果无法返回任何指定的属性，则服务提供程序应返回WMDM_E_NOTSUPPORTED或任何合适的错误代码。

如果至少可以检索一个属性，则服务提供商应返回该属性，并将返回代码设置为WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED的成功代码。