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

  • [アーティクル]

ルート メタデータ ブロックに対する現在のパスを取得します。

構文

HRESULT GetLocation(
  [in]      UINT  cchMaxLength,
  [in, out] WCHAR *wzNamespace,
  [out]     UINT  *pcchActualLength
);

パラメーター

[in] cchMaxLength

型: UINT

wzNamespace バッファーの長さ。

[in, out] wzNamespace

種類: WCHAR*

現在の名前空間の場所を受け取るポインター。

[out] pcchActualLength

種類: UINT*

現在の名前空間の場所を取得するために必要だった実際のバッファー長。

戻り値

種類: HRESULT

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

解説

NULL をwzNamespace に渡すと、GetLocation は cchMaxLength を無視し、pcchActualLength が指す変数にパスを格納するために必要なバッファー長を返します。

クエリ リーダーがメタデータ階層の最上位を基準とする場合は、単一文字の文字列が返されます。

クエリ リーダーが入れ子になったメタデータ ブロックを基準とする場合、このメソッドは現在のクエリ リーダーへのパスを返します。

要件

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

関連項目

概念

IWICMetadataQueryReader

画像メタデータの読み取りと書き込みの概要

WIC メタデータの概要