IDebugEventCallbacks：：ChangeSymbolState 方法 (dbgeng.h)

  • 發行項

當符號狀態變更時，引擎會呼叫 ChangeSymbolState 回呼方法。

語法

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

參數

[in] Flags

指定位集，指出變更符號狀態的本質。 可能會設定下列位旗標。

值 Description
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 的值是在引擎卸除符號的模組映像) 目標記憶體位址空間中的基底位置 (。 如果引擎卸除多個影像的符號， Argument 的值會是零。

DEBUG_CSS_SCOPE

Argument 的值是零。

DEBUG_CSS_PATHS

Argument 的值是零。

DEBUG_CSS_SYMBOL_OPTIONS

Argument 的值是符號選項。

DEBUG_CSS_TYPE_OPTIONS

Argument 的值是零。

傳回值

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

備註

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

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

規格需求

需求 值
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)