ICorDebugController::Stop 方法
在執行處理序中受控程式碼的所有執行緒上執行合作式停止。
語法
HRESULT Stop (
[in] DWORD dwTimeoutIgnored
);
參數
dwTimeoutIgnored
未使用。
備註
Stop
會在執行處理序中受控程式碼的所有執行緒上執行合作式停止。 在僅受控偵錯工作階段期間,非受控執行緒可能會繼續執行 (但在嘗試呼叫受控程式碼時將會遭到封鎖)。 在 Interop 偵錯工作階段期間,非受控執行緒也會停止。 dwTimeoutIgnored
值目前會被忽略,並視為 INFINITE (-1)。 如果合作式停止由於死結而失敗,則會暫停所有執行緒,並傳回 E_TIMEOUT。
注意
Stop
是偵錯 API 中唯一的同步方法。 當 Stop
傳回 S_OK 時,處理序即會停止。 沒有提供回呼來通知接聽程式發生停止。 偵錯工具必須呼叫 ICorDebugController::Continue,才能讓處理序繼續。
偵錯工具會維護停止計數器。 當計數器進入零時,控制器就會繼續。 每次呼叫 Stop
或每次分派回呼都會讓計數器遞增。 每次呼叫 ICorDebugController::Continue
都會讓計數器遞減。
規格需求
平台:請參閱系統需求。
標頭:CorDebug.idl、CorDebug.h
程式庫:CorGuids.lib
.NET Framework版本:自 1.0 起提供