<Return[C]><Top>

CreateToolhelp32Snapshot

Declare Function Api_CreateToolhelp32Snapshot& Lib "kernel32" Alias "CreateToolhelp32Snapshot" (ByVal dwFlag&, ByVal th32ProcessID&)

Declare Function CreateToolhelp32Snapshot Lib "kernel32" (ByVal dwFlags As Long, ByVal th32ProcessID As Long) As Long

プロセスと、プロセスが使っているヒープ、モジュール、スレッドのスナップショットを作成する。

パラメータ
dwFlags
    システムのどの部分をスナップショットに含めたいかを指定する。次の値のいずれかを指定する。

    値                                       

意味                                                                                                                     

    TH32CS_INHERIT

スナップショットのハンドルが継承可能であることを意味する。

    TH32CS_SNAPALL

TH32CS_SNAPHEAPLIST、TH32CS_SNAPMODULE、TH32CS_SNAPPROCESS、

　

TH32CS_SNAPTHREAD のすべてを指定したのと同じことを意味する。

    TH32CS_SNAPHEAPLIST

指定されたプロセスのヒープリストを、スナップショットに含める。

    TH32CS_SNAPMODULE

指定されたプロセスのモジュールリストを、スナップショットに含める。

    TH32CS_SNAPPROCESS

プロセスリストを、スナップショットに含める。

    TH32CS_SNAPTHREAD

スレッドリストを、スナップショットに含める。

th32ProcessID
    プロセス識別子を指定する。0 を指定すると、現在のプロセスが表せる。

    TH32CS_SNAPHEAPLIST、または TH32CS_SNAPMODULE フラグをセットしたときに、このパラメータが使われる。

    それ以外の場合は、このパラメータは無視される。

 
戻り値
    関数が成功すると、指定されたスナップショットのハンドルが返る。

    関数が失敗すると、-1 が返る。