IDebugBreakpoint2：：GetPassCount 方法 (dbgeng.h)

  • 發行項

GetPassCount 方法會傳回在觸發斷點之前，原本需要目標到達斷點位置的次數。

語法

HRESULT GetPassCount(
  [out] PULONG Count
);

參數

[out] Count

在觸發目標之前，必須先達到斷點的次數。 目標原本需要傳遞斷點而不觸發的次數，就是傳 回 Count 的值減一。

傳回值

傳回碼 描述
S_OK
 此方法成功。
 

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

備註

GetPassCount 方法會傳回原本觸發斷點所需的點擊次數。 GetCurrentPassCount 方法會傳回仍然必須發生的點擊次數，以觸發斷點。 例如，如果已使用 20 個傳遞計數建立斷點，而且到目前為止已通過 5 個，則此方法 GetPassCount 會傳回 20， 而 GetCurrentPassCount 會傳回 15。

在目標達到足夠的時間觸發斷點之後，除非呼叫 SetPassCount，否則每次叫用斷點時都會觸發斷點。 您也可以呼叫 SetPassCount ，在觸發斷點之前變更傳遞計數。 此呼叫會重設原始的傳遞計數和剩餘的傳遞計數。

如果調試程式在逐步執行程式代碼時於斷點位置執行程式碼，此執行不會參與觸發斷點之前所保留的次數。

GetParameters 方法也會傳回 Count 中傳回的資訊。

如需斷點屬性的詳細資訊，請參閱 控制斷點旗標和參數。

規格需求

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