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