GetProcessImageFileNameW

指定プロセスの実行ファイル名を取得する。(Unicode)

GetProcessImageFileNameW hProcess, lpImageFileName, nSize

hProcess : [intptr] プロセスのハンドル。PROCESS_QUERY_INFORMATION または PROCESS_QUERY_LIMITED_INFORMATION アクセス権が必要。Windows Server 2003/Windows XP: PROCESS_QUERY_INFORMATION が必要。
lpImageFileName : [wstr] 実行ファイルへの完全パスを受け取るバッファへのポインタ。
nSize : [int] lpImageFileName バッファのサイズ(文字単位)。

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

解説

指定プロセスの実行ファイル名を取得する。(Unicode)

[戻り値]
成功時はバッファにコピーされた文字列長を返す。失敗時は 0。拡張エラー情報は GetLastError で取得する。

[備考]
Psapi.dll は %windir%\System32
にインストールされる。別の場所に複製があるとエントリポイントのエラーが起こるため、対処として別の場所のものを削除/リネームする必要がある。本関数はドライブレターではなくデバイス形式のパスを返す(例:
\Device\Harddisk0\Partition1\... )。現プロセスのモジュール名取得には GetModuleFileName
の方が効率的。Win32 パス形式が必要なら QueryFullProcessImageName を使う。PSAPI_VERSION
関連は他の psapi 関数と同様。
> [!NOTE] > psapi.h は UNICODE マクロに応じて GetProcessImageFileName を
ANSI/Unicode 版のエイリアスとして定義する。

情報

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