IShellLinkW_SetRelativePath

シェルリンクオブジェクトへの相対パスを設定する。(Unicode)

IShellLinkW_SetRelativePath this, pszPathRel, dwReserved

this : [comobj] IShellLinkW インターフェースの COM オブジェクト変数
pszPathRel : [wstr] 型: LPCTSTR ショートカット解決の基準となるショートカットファイルの完全修飾パスを含むバッファのアドレス。フォルダー名ではなくファイル名でなければならない。
dwReserved : [int] 型: DWORD 予約済み。このパラメーターには 0 を設定する。

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

解説

シェルリンクオブジェクトへの相対パスを設定する。(Unicode)

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

[備考]

クライアントはリンクがターゲットとともに移動される可能性があり、絶対パスが無効になる場合に、相対リンクを定義することがある。SetRelativePath
メソッドは、ターゲットと相対パスとの間の共通のパスプレフィックスに基づいてリンク解決プロセスがターゲットを見つけるのを助けるのに使える。解決プロセスを支援するため、クライアントはリンク作成プロセスの一部として相対パスを設定するべきである。

情報

プラグイン / モジュール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