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または適切なエラーコードを返す必要があります。

少なくとも 1 つのプロパティを取得できる場合、サービスプロバイダーはそのプロパティを返し、戻りコードを WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED の成功コードに設定する必要があります。