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碼。