次の方法で共有

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

  • [アーティクル]

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

構文

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

パラメーター

[in] Flags

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

価値 形容
DEBUG_CSS_LOADS エンジンによっていくつかのモジュール シンボルが読み込まれました。
DEBUG_CSS_UNLOADS エンジンによって、いくつかのモジュール シンボルがアンロードされました。
DEBUG_CSS_SCOPE 現在のシンボル スコープが変更されました。
DEBUG_CSS_PATHS 実行可能イメージ、ソース、またはシンボルの検索パスが変更されました。
DEBUG_CSS_SYMBOL_OPTIONS シンボル オプションが変更されました。
DEBUG_CSS_TYPE_OPTIONS 型オプションが変更されました。

[in] Argument

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

DEBUG_CSS_LOADS

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

DEBUG_CSS_UNLOADS

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

DEBUG_CSS_SCOPE

引数 の値は 0 です。

DEBUG_CSS_PATHS

引数 の値は 0 です。

DEBUG_CSS_SYMBOL_OPTIONS

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

DEBUG_CSS_TYPE_OPTIONS

引数 の値は 0 です。

戻り値

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

備考

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

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Dbgeng.h を含む)