IDebugEventCallbacks::UnloadModule メソッド (dbgeng.h)
UnloadModule コールバック メソッドは、ターゲットでモジュール アンロード デバッグ イベントが発生したときにエンジンによって呼び出されます。
構文
HRESULT UnloadModule(
[in, optional] PCSTR ImageBaseName,
[in] ULONG64 BaseOffset
);
パラメーター
[in, optional] ImageBaseName
パスを含めることができるモジュールのイメージ ファイルの名前を指定します。 この情報を使用できない場合、 ImageBaseName は NULL になります。
[in] BaseOffset
ターゲットのメモリ アドレス空間内のモジュールのベース アドレスを指定します。 この情報が使用できない場合、 BaseOffset は NULL になります。
戻り値
このメソッドは 、DEBUG_STATUS_XXX 値を返します。これは、エンジンがこのイベントを処理した後にターゲットの実行を続行する方法を示します。 エンジンがこの値を処理する方法の詳細については、「 イベントの監視」を参照してください。
注釈
このメソッドは、 IDebugEventCallbacks::GetInterestMask によって返されるマスクでDEBUG_EVENT_UNLOAD_MODULE フラグが設定されている場合にのみ、エンジンによって呼び出されます。
このメソッドを呼び出すと、エンジンは IDebugEventCallbacks::ChangeSymbolState を呼び出し、 Flags パラメーターにはビット フラグDEBUG_CSS_UNLOADSが含まれます。
イベントの処理の詳細については、「 イベントの監視」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |