IDebugEventCallbacks::CreateProcess メソッド (dbgeng.h)
CreateProcess コールバック メソッドは、ターゲットで create-process デバッグ イベントが発生したときにエンジンによって呼び出されます。
構文
HRESULT CreateProcess(
[in] ULONG64 ImageFileHandle,
[in] ULONG64 Handle,
[in] ULONG64 BaseOffset,
[in] ULONG ModuleSize,
[in, optional] PCSTR ModuleName,
[in, optional] PCSTR ImageName,
[in] ULONG CheckSum,
[in] ULONG TimeDateStamp,
[in] ULONG64 InitialThreadHandle,
[in] ULONG64 ThreadDataOffset,
[in] ULONG64 StartOffset
);
パラメーター
[in] ImageFileHandle
プロセスのイメージ ファイルへのハンドルを指定します。 この情報を使用できない場合、ImageFileHandle は NULL されます。
[in] Handle
プロセスのハンドルを指定します。 このパラメーターは、CREATE_PROCESS_DEBUG_INFO構造体の hProcess フィールドに対応します。 この情報を使用できない場合、ImageFileHandle は NULL されます。
[in] BaseOffset
ターゲットのメモリ アドレス空間内のプロセスの実行可能イメージのベース アドレスを指定します。 この情報を使用できない場合、BaseOffset は NULL されます。
[in] ModuleSize
プロセスの実行可能イメージサイズをバイト単位で指定します。 この情報を使用できない場合、ModuleSize は 0 になります。
[in, optional] ModuleName
デバッガー エンジンによって使用される簡略化されたモジュール名を指定します。 ほとんどの場合、これは拡張子を除くイメージ ファイル名と一致します。 この情報を使用できない場合は、ModuleName NULL されます。
[in, optional] ImageName
パスを含めることができるプロセスの実行可能イメージ ファイル名を指定します。 この情報を使用できない場合、ImageName は NULL されます。
[in] CheckSum
プロセスの実行可能イメージのチェックサムを指定します。 この情報を使用できない場合、CheckSum は 0 になります。
[in] TimeDateStamp
プロセスの実行可能イメージ ファイルの日時スタンプを指定します。 この情報が使用できない場合、timeDateStamp は 0 になります。
[in] InitialThreadHandle
プロセスの初期スレッドへのハンドルを指定します。 このパラメーターは、CREATE_PROCESS_DEBUG_INFO構造体の hThread フィールドに対応します。 この情報を使用できない場合、InitialThreadHandle は NULL されます。
[in] ThreadDataOffset
オペレーティング システムがこのスレッドに対して保持するデータ ブロックを指定します。 ブロック内の実際のデータはオペレーティング システム固有です。 この情報を使用できない場合、ThreadDataOffset は NULL されます。
[in] StartOffset
プロセスの仮想アドレス空間内のスレッドの開始アドレスを指定します。 この情報を使用できない場合、StartOffset は NULL されます。
戻り値
このメソッドは、DEBUG_STATUS_XXX 値を返します。これは、エンジンがこのイベントを処理した後にターゲットの実行を続行する方法を示します。 エンジンによるこの値の処理方法の詳細については、「監視イベントの」を参照してください。
備考
このメソッドは、IDebugEventCallbacks::GetInterestMaskによって返されるマスクにDEBUG_EVENT_CREATE_PROCESS フラグが設定されている場合にのみ、エンジンによって呼び出されます。
イベントの処理の詳細については、「監視イベントの」を参照してください。 スレッドの詳細については、「スレッドとプロセスの」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | dbgeng.h (Dbgeng.h を含む) |