K32GetModuleFileNameExW

指定したモジュールを含むファイルの完全修飾パスを取得する。(Unicode)

K32GetModuleFileNameExW hProcess, hModule, lpFilename, nSize

hProcess : [intptr] モジュールを含むプロセスへのハンドル。ハンドルは PROCESS_QUERY_INFORMATION と PROCESS_VM_READ アクセス権を持っていなければならない。詳細は Process Security and Access Rights を参照のこと。Windows 10 以降、Windows Server 2016 以降: hModule パラメータが NULL の場合、ハンドルは PROCESS_QUERY_LIMITED_INFORMATION アクセス権だけで足りる。GetModuleFileNameEx 関数は LOAD_LIBRARY_AS_DATAFILE フラグで読み込まれたモジュールのパスは取得しない。詳細は LoadLibraryEx を参照のこと。
hModule : [intptr] モジュールへのハンドル。NULL の場合、GetModuleFileNameEx は hProcess で指定したプロセスの実行可能ファイルのパスを返す。
lpFilename : [wstr] モジュールの完全修飾パスを受け取るバッファへのポインタ。ファイル名のサイズが nSize パラメータの値より大きい場合、関数は成功するがファイル名は切り詰められ null 終端される。
nSize : [int] lpFilename バッファのサイズ（文字数単位）。

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

解説

指定したモジュールを含むファイルの完全修飾パスを取得する。(Unicode)

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

[備考]
GetModuleFileNameEx
関数は主にデバッガや、他プロセスからモジュール情報を抽出する類似アプリケーションでの使用を目的としている。ターゲット プロセスのモジュール
リストが壊れている、もしくはまだ初期化されていない、あるいは DLL の読み込み・アンロードの結果として関数呼び出し中にモジュール
リストが変わる場合、GetModuleFileNameEx
は失敗したり誤った情報を返すことがある。現在のプロセス内のモジュールの名前を取得するには GetModuleFileName
関数を使う。これは現在のプロセスのハンドルを指定して GetModuleFileNameEx を呼ぶよりも効率的かつ信頼性が高い。リモート
プロセスのメイン実行可能モジュールの名前を取得するには GetProcessImageFileName または
QueryFullProcessImageName 関数を使う。これは NULL のモジュール ハンドルを指定して
GetModuleFileNameEx を呼ぶよりも効率的かつ信頼性が高い。Windows 7 および Windows Server
2008 R2 以降、Psapi.h は PSAPI 関数のバージョン番号を定めている。PSAPI
バージョン番号は、関数を呼ぶときに使う名前とプログラムが読み込むライブラリに影響する。PSAPI_VERSION が 2
以上の場合、この関数は Psapi.h で K32GetModuleFileNameEx として定義され、Kernel32.lib と
Kernel32.dll にエクスポートされる。PSAPI_VERSION が 1 の場合、Psapi.h で
GetModuleFileNameEx として定義され、Psapi.lib と Psapi.dll に
K32GetModuleFileNameEx を呼ぶラッパーとしてエクスポートされる。旧バージョンの Windows と Windows
7 以降の両方で動かすプログラムは常に GetModuleFileNameEx
として呼ぶべきである。シンボルを正しく解決するためには、TARGETLIBS マクロに Psapi.lib
を追加し、-DPSAPI_VERSION=1 付きでコンパイルする。実行時動的リンクを使うには Psapi.dll を読み込む。

情報