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 起提供

另請參閱