ICorDebugController::Stop Method

  • Article

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.

NoteNote:

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 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 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

See Also

Concepts

ICorDebugController Interface