ICorDebugController::Stop Method
Performs a cooperative stop on all threads that are running managed code in the process.
HRESULT Stop (
[in] DWORD dwTimeoutIgnored
);
Parameters
- dwTimeoutIgnored
Not used.
Remarks
Stop performs a cooperative stop on all threads running managed code in the process. During a managed-only debugging session, unmanaged threads may continue to run (but will be blocked when trying to call managed code). During an interop debugging session, unmanaged threads will also be stopped. The dwTimeoutIgnored value is currently ignored and treated as INFINTE (-1). If the cooperative stop fails due to a deadlock, all threads are suspended and E_TIMEOUT is returned.
Note
Stop is the only synchronous method in the debugging API. When Stop returns S_OK, the process is stopped. No callback is given to notify listeners of the stop. The debugger must call ICorDebugController::Continue Method to allow the process to resume.
The debugger maintains a stop counter. When the counter goes to zero, the controller is resumed. Each call to Stop or each dispatched callback increments the counter. Each call to ICorDebugController::Continue Method decrements the counter.
Requirements
Platforms: Windows 2000, Windows XP, Windows Server 2003 family
Header: CorDebug.idl
Library: CorGuids.lib
.NET Framework Version: 2.0, 1.1, 1.0