GetMappedFileNameW

指定されたアドレスが、指定プロセスのアドレス空間内のメモリマップトファイルの中にあるかを確認する。該当する場合、関数はそのメモリマップトファイルの名前を返す。(Unicode)

GetMappedFileNameW hProcess, lpv, lpFilename, nSize

hProcess : [intptr] プロセスのハンドル。ハンドルには PROCESS_QUERY_INFORMATION アクセス権が必要である。詳細は「Process Security and Access Rights」を参照。
lpv : [intptr] 検証するアドレス。
lpFilename : [wstr] lpv で指定したアドレスが属するメモリマップトファイルの名前を受け取るバッファへのポインタ。
nSize : [int] lpFilename バッファのサイズ(文字数)。

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

解説

指定されたアドレスが、指定プロセスのアドレス空間内のメモリマップトファイルの中にあるかを確認する。該当する場合、関数はそのメモリマップトファイルの名前を返す。(Unicode)

[戻り値]
関数が成功した場合、戻り値はバッファにコピーされた文字列の長さ(文字数)となる。関数が失敗した場合、戻り値は 0
となる。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
Windows 7 および Windows Server 2008 R2 以降、Psapi.h は PSAPI
関数群にバージョン番号を設定している。PSAPI
バージョン番号は、関数を呼び出す際に使用する名前と、プログラムがロードする必要のあるライブラリに影響を与える。PSAPI_VERSION
が 2 以上の場合、この関数は Psapi.h で K32GetMappedFileName として定義され、Kernel32.lib
および Kernel32.dll からエクスポートされる。PSAPI_VERSION が 1 の場合、この関数は Psapi.h で
GetMappedFileName として定義され、K32GetMappedFileName を呼び出すラッパーとして Psapi.lib
および Psapi.dll からエクスポートされる。Windows の旧バージョンと Windows 7
以降の両方で動作する必要があるプログラムは、常に GetMappedFileName
として呼び出すべきである。シンボル解決を正しく行うには、TARGETLIBS マクロに Psapi.lib
を追加し、-DPSAPI_VERSION=1 を指定してプログラムをコンパイルする。実行時動的リンクを利用するには、Psapi.dll
をロードする。Windows Server 2012 では、この関数は次のテクノロジーでサポートされる。
(以下省略)

情報

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