GetModuleHandleExW 関数 (libloaderapi.h)

[アーティクル]
11/20/2024

指定したモジュールのモジュールハンドルを取得し、GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNTが指定されていない限り、モジュールの参照カウントをインクリメントします。モジュールは、呼び出し元プロセスによって読み込まれている必要があります。

構文

BOOL GetModuleHandleExW(
  [in]           DWORD   dwFlags,
  [in, optional] LPCWSTR lpModuleName,
  [out]          HMODULE *phModule
);

パラメーター

[in] dwFlags

このパラメーターには、0 個または 1 つ以上の次の値を指定できます。モジュールの参照カウントがインクリメントされた場合、呼び出し元は FreeLibrary 関数を使用して、モジュールハンドルが不要になったときに参照カウントを減らす必要があります。

GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS (0x00000004)

lpModuleName パラメーターは、モジュール内のアドレスです。

GET_MODULE_HANDLE_EX_FLAG_PIN (0x00000001)

FreeLibrary の呼び出し回数に関係なく、プロセスが終了するまでモジュール読み込まれたままです。

このオプションは、GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNTでは使用できません。

GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT (0x00000002)

モジュールの参照カウントはインクリメントされません。このオプションは、GetModuleHandleの動作と同じです。取得したモジュールハンドルを FreeLibrary 関数に渡さないでください。これを行うと、DLL が途中でマップ解除される可能性があります。詳細については、「解説」を参照してください。

このオプションは、GET_MODULE_HANDLE_EX_FLAG_PINでは使用できません。

[in, optional] lpModuleName

読み込まれたモジュールの名前 (.dll または .exe ファイル) またはモジュール内のアドレス (dwFlags がGET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESSされている場合)。

モジュール名の場合、ファイル名拡張子を省略すると、既定のライブラリ拡張機能 .dll が追加されます。ファイル名の文字列には、モジュール名に拡張子がないことを示す末尾のポイント文字 (.) を含めることができます。文字列はパスを指定する必要はありません。パスを指定するときは、スラッシュ (/) ではなく円記号 (\) を使用してください。名前は、呼び出し元プロセスのアドレス空間に現在マップされているモジュールの名前と (大文字と小文字を区別せず) 比較されます。

このパラメーターが NULL の場合、関数は呼び出し元プロセス (.exe ファイル) の作成に使用されるファイルにハンドルを返します。

[out] phModule

指定したモジュールへのハンドル。関数が失敗した場合、このパラメーターは NULL。

GetModuleHandleEx 関数は、LOAD_LIBRARY_AS_DATAFILE フラグを使用して読み込まれたモジュールのハンドルを取得しません。詳細については、「LoadLibraryExを参照してください。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。拡張エラー情報を取得するには、GetLastErrorを参照してください。

備考

返されるハンドルはグローバルでも継承可能でありません。別のプロセスで複製または使用することはできません。

lpModuleName パスが含まれず、同じベース名と拡張子を持つ複数の読み込まれたモジュールがある場合、返されるモジュールハンドルを予測することはできません。この問題を回避するには、パスを指定するか、サイドバイサイドアセンブリを使用するか、lpModuleName パラメーターに DLL 名ではなくメモリの場所を指定します。

dwFlags GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNTが含まれている場合、GetModuleHandleEx 関数は、参照カウントをインクリメントせずにマップされたモジュールにハンドルを返します。ただし、このハンドルを FreeLibrary 関数に渡すと、マップされたモジュールの参照カウントがデクリメントされます。そのため、GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNTを使用して GetModuleHandleEx 返されたハンドルを、FreeLibrary 関数に渡さないでください。これを行うと、DLL モジュールが途中でマップ解除される可能性があります。

dwFlags GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNTが含まれている場合は、マルチスレッドアプリケーションでこの関数を慎重に使用する必要があります。この関数がハンドルを返してから使用されてからの間、モジュールハンドルが有効なままであるという保証はありません。たとえば、スレッドはモジュールハンドルを取得しますが、ハンドルを使用する前に、2 番目のスレッドによってモジュールが解放されます。システムが別のモジュールを読み込む場合は、最近解放されたモジュールハンドルを再利用できます。したがって、最初のスレッドは、意図したモジュールとは異なるモジュールへのハンドルを持つことになります。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNTを 0x0501 以降として定義します。詳細については、「Windows ヘッダーの使用」を参照してください。

手記

ヘッダーは、getModuleHandleEx を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	libloaderapi.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll

次の方法で共有

GetModuleHandleExW 関数 (libloaderapi.h)

構文

パラメーター

GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS (0x00000004)

GET_MODULE_HANDLE_EX_FLAG_PIN (0x00000001)

GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT (0x00000002)

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース