GetModuleInformation 関数 (psapi.h)

MODULEINFO 構造体内の指定されたモジュールに関する情報を取得します。

構文

BOOL GetModuleInformation(
  [in]  HANDLE       hProcess,
  [in]  HMODULE      hModule,
  [out] LPMODULEINFO lpmodinfo,
  [in]  DWORD        cb
);

パラメーター

[in] hProcess

モジュールを含むプロセスのハンドル。

ハンドルには、PROCESS_QUERY_INFORMATIONと PROCESS_VM_READ アクセス権 が 必要です。 詳細については、「 セキュリティとアクセス権の処理」を参照してください。

[in] hModule

モジュールへのハンドル。

[out] lpmodinfo

モジュールに関する情報を受け取る MODULEINFO 構造体へのポインター。

[in] cb

MODULEINFO 構造体のサイズ (バイト単位)。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

呼び出し元プロセスの情報を取得するには、 GetCurrentProcess によって返されるハンドルを渡します。

GetModuleInformation 関数は、LOAD_LIBRARY_AS_DATAFILE フラグで読み込まれたモジュールの情報を取得しません。 詳細については、「 LoadLibraryEx」を参照してください。

Windows 7 および Windows Server 2008 R2 以降、Psapi.h は PSAPI 関数のバージョン番号を確立します。 PSAPI バージョン番号は、関数の呼び出しに使用される名前と、プログラムが読み込む必要があるライブラリに影響します。

PSAPI_VERSIONが 2 以上の場合、この関数は Psapi.h で K32GetModuleInformation として定義され、Kernel32.lib および Kernel32.dll でエクスポートされます。 PSAPI_VERSIONが 1 の場合、この関数は Psapi.h で K32GetModuleInformation として定義され、Psapi.lib でエクスポートされ、K32GetModuleInformation を呼び出すラッパーとして Psapi.dll されます。

以前のバージョンの Windows および Windows 7 以降のバージョンで実行する必要があるプログラムは、常にこの関数を K32GetModuleInformation として呼び出す必要があります。 シンボルを正しく解決するには、PSapi.lib を TARGETLIBS マクロに追加し、 -DPSAPI_VERSION=1 でプログラムをコンパイルします。 実行時の動的リンクを使用するには、Psapi.dll を読み込みます。

要件

こちらもご覧ください

EnumProcesses

MODULEINFO

モジュール情報

PSAPI 関数