IWICMetadataQueryReader_GetLocation

ルートメタデータブロックからの現在のパスを取得する。

IWICMetadataQueryReader_GetLocation this, cchMaxLength, wzNamespace, pcchActualLength

this : [comobj] IWICMetadataQueryReader インターフェースの COM オブジェクト変数
cchMaxLength : [int] 型: UINT wzNamespace バッファの長さ。
wzNamespace : [wstr] 型: WCHAR* 現在の名前空間の場所を受け取るポインタ。
pcchActualLength : [int] 型: UINT* 現在の名前空間の場所を取得するために必要な実際のバッファ長。

(プラグイン / モジュール : com_misc.dll)

解説

ルートメタデータブロックからの現在のパスを取得する。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。それ以外の場合は HRESULT エラーコードを返す。

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

クエリリーダーがメタデータ階層の最上位に対して相対的である場合は単一文字の文字列を返す。クエリリーダーがネストされたメタデータブロックに対して相対的である場合、このメソッドは現在のクエリリーダーへのパスを返す。

情報

プラグイン / モジュールcom_misc.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の com_misc.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_com_misc_gen2.hs