<Return[MN]><Top>

Module32First

Declare Function Api_Module32First& Lib "kernel32" Alias "Module32First" (ByVal hSnapshot&, uProcess As MODULEENTRY32)

Declare Function Module32First Lib "kernel32" (ByVal hSnapshot As Long, uProcess As MODULEENTRY32) As Long

プロセスに関連付けられている最初のモジュールに関する情報を取得する。

パラメータ
hSnapshot
    直前に CreateToolhelp32Snapshot 関数を呼び出したときに返されたスナップショットのハンドルを指定する。
lpme
   MODULEENTRY32 構造体へのポインタを指定する。
 

戻り値
    モジュールリストの最初のエントリがバッファへコピーされた場合は、TRUE が返る。

    それ以外の場合は、FALSE が返る。モジュールが存在しない場合や、スナップショットがモジュール情報を保持していない場合は、

    GetLastError 関数は ERROR_NO_MORE_FILES エラー値を返す。

解説
    呼び出し側のアプリケーションは、MODULEENTRY32 構造体の dwSize メンバを、この構造体のバイト単位のサイズに設定しなければな

    らない。

    Module32First 関数は dwSize メンバを、この構造体に書き込まれたバイト数に変更する。

    後者の値は dwSize メンバの最初の値を上回ることはないが、それより小さくなることはある。

    後者の値が最初の値より小さくなっていた場合、後者の値を上回るオフセット値を持つメンバの値を信頼しないこと。
    指定されたプロセスに関連付けられている他のモジュールに関する情報を取得するには、Module32Next 関数を使う。