IDebugControl3::GetNumberEvents 方法 (dbgeng.h)

如果已修正事件數目, GetNumberEvents 方法會傳回目前目標 的事件 數目。

語法

HRESULT GetNumberEvents(
  [out] PULONG Events
);

參數

[out] Events

接收儲存在目標中的事件數目。 如果目標提供多個事件, 事件 將會設定為可用的事件數目。 否則, 事件 會設定為一個。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值

傳回碼 描述
S_OK
方法成功,而 Events 包含目標可能的事件總數。
S_FALSE
方法成功,但 Events 只包含目前可能的事件總數。 支援變數執行的目標可能會在目標執行期間的不同點提供不同的事件集。

備註

損毀傾印檔案包含靜態事件清單;每個事件都代表特定時間點的目標快照集。 如果目前的目標是損毀傾印檔案,這個方法會將 Events 設定為預存事件的數目,並傳回S_OK。

實時目標會動態產生事件,而且不一定有一組已知的事件。 如果目前的目標是具有不受限制事件數目的實時目標,此方法會將 事件 設定為目前可用的事件數目,並傳回S_FALSE。

如需詳細資訊,請參閱 事件信息主題。

規格需求

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

另請參閱

GetCurrentEventIndex

IDebugControl3

SetNextEventIndex