IWICMetadataQueryReader::GetMetadataByName メソッド (wincodec.h)

メタデータクエリ式によって識別されるメタデータブロックまたは項目を取得します。

構文

HRESULT GetMetadataByName(
  [in]      LPCWSTR     wzName,
  [in, out] PROPVARIANT *pvarValue
);

[in] wzName

種類: LPCWSTR

要求されたメタデータブロックまたはアイテムに対するクエリ式。

[in, out] pvarValue

このメソッドが返されるときに、要求されたメタデータブロックまたはアイテムが格納されます。

種類: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

GetMetadataByName は、メタデータクエリ式を使用して埋め込みメタデータにアクセスします。メタデータクエリ言語の詳細については、「メタデータクエリ言語の概要」を参照してください。

同じクエリ式で表される複数のブロックまたは項目が存在する場合は、最初に見つかったメタデータブロックまたは項目が返されます。

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	wincodec.h
Library	Windowscodecs.lib
[DLL]	Windowscodecs.dll