IDebugEventCallbacks::ChangeSymbolState メソッド (dbgeng.h)

ChangeSymbolState コールバック メソッドは、シンボルの状態が変化したときにエンジンによって呼び出されます。

構文

HRESULT ChangeSymbolState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

パラメーター

[in] Flags

シンボル状態への変更の性質を示すビット セットを指定します。 次のビット フラグが設定されている可能性があります。

[in] Argument

シンボル状態の変更に関する追加情報を提供します。 Flags パラメーターに複数のビット フラグが設定されている場合、Argument パラメーターは使用されません。 それ以外の場合、 Argument の値は Flags の値によって異なります。

DEBUG_CSS_LOADS

Argument の値は、エンジンがシンボルを読み込んだモジュール イメージの基本位置 (ターゲットのメモリ アドレス空間内) です。

DEBUG_CSS_UNLOADS

Argument の値は、エンジンがシンボルをアンロードしたモジュール イメージの基本位置 (ターゲットのメモリ アドレス空間内) です。 複数のイメージに対してエンジンがシンボルをアンロードした場合、 Argument の値は 0 になります。

DEBUG_CSS_SCOPE

Argument の値は 0 です。

DEBUG_CSS_PATHS

Argument の値は 0 です。

DEBUG_CSS_SYMBOL_OPTIONS

引数の値はシンボル オプションです。

DEBUG_CSS_TYPE_OPTIONS

Argument の値は 0 です。

戻り値

戻り値は、リモート プロシージャ コール エラーを示さない限り、エンジンによって無視されます。この場合、この IDebugEventCallbacks オブジェクトが登録されているクライアントは無効になります。

注釈

このメソッドは、 IDebugEventCallbacks::GetInterestMask によって返されるマスクにDEBUG_EVENT_CHANGE_SYMBOL_STATE フラグが設定されている場合にのみ、エンジンによって呼び出されます。

イベントの処理の詳細については、「 イベントの監視」を参照してください。

要件