<Return[G]><Top>

GetModuleHandle

Declare Function Api_GetModuleHandle& Lib "kernel32" Alias "GetModuleHandleA" (ByVal ModuleName$)

Declare Function GetModuleHandle Lib "kernel32" Alias "GetModuleHandleA" (ByVal lpModuleName As String) As Long

呼び出し側プロセスのアドレス空間に該当ファイルがマップされている場合、指定されたモジュール名のモジュールハンドルを返す。

パラメータ
lpModuleName
    [入力]モジュール(.DLL または .EXE ファイル)の名前を保持する、NULL で終わる文字列へのポインタを指定する。

    拡張子を記述しなかった場合は、既定で「.DLL」が追加される。

    文字列の最後に「.」を記述すると、拡張子なしのモジュール名になる。文字列には、パスを指定しなくてもかまわない。

    パスを指定する場合は、スラッシュ(/)ではなく円記号(\)で区切ること。指定されたモジュール名を、呼び出し側プロセスのアドレス空

    間に現在マップされているモジュール名と比較する( 大文字と小文字を区別しない)。
    NULL を指定すると、呼び出し側プロセスの作成に使われたファイルのハンドルが返る。

戻り値
    関数が成功すると、指定したモジュールのハンドルが返る。
    関数が失敗すると、NULL が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。