K32GetModuleBaseNameW

指定したモジュールのベース名を取得する。(Unicode)

K32GetModuleBaseNameW hProcess, hModule, lpBaseName, nSize

hProcess : [intptr] モジュールを含むプロセスへのハンドル。ハンドルは PROCESS_QUERY_INFORMATION と PROCESS_VM_READ アクセス権を持っていなければならない。詳細は Process Security and Access Rights を参照のこと。
hModule : [intptr] モジュールへのハンドル。NULL の場合、この関数は呼び出し側プロセスの作成に使われたファイルの名前を返す。
lpBaseName : [wstr] モジュールのベース名を受け取るバッファへのポインタ。ベース名が nSize パラメータで指定した最大文字数より長ければ切り詰められる。
nSize : [int] lpBaseName バッファのサイズ（文字数単位）。

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

解説

指定したモジュールのベース名を取得する。(Unicode)

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

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

情報