共用方式為

IDebugEventCallbacksWide：：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 參數。 否則，Argument 的值取決於 flags 的值：

DEBUG_CSS_LOADS

Argument 的值是引擎載入符號之模組映像的基底位置（在目標記憶體位址空間中）。

DEBUG_CSS_UNLOADS

Argument 的值是引擎卸除符號之模組映像的基底位置（在目標記憶體位址空間中）。 如果引擎卸除多個影像的符號，自變數 的值 為零。

DEBUG_CSS_SCOPE

Argument 的值為零。

DEBUG_CSS_PATHS

Argument 的值為零。

DEBUG_CSS_SYMBOL_OPTIONS

Argument 的值是符號選項。

DEBUG_CSS_TYPE_OPTIONS

Argument 的值為零。

傳回值

除非引擎指出遠程過程調用錯誤，否則會忽略傳回值;在此情況下，會停用此 IDebugEventCallbacksWide 物件的用戶端。

言論

只有在 IDebugEventCallbacksWide：：GetInterestMask 所傳回的遮罩中設定了DEBUG_EVENT_CHANGE_SYMBOL_STATE旗標時，引擎才會呼叫這個方法。

如需處理事件的詳細資訊，請參閱 監視事件。

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h）