Share via


ICorDebugManagedCallback2::ChangeConnection Method

Notifies the debugger that the set of tasks associated with the specified connection has changed.

HRESULT ChangeConnection (
    [in] ICorDebugProcess     *pProcess,
    [in] CONNID               dwConnectionId
);

Parameters

  • pProcess
    [in] A pointer to an ICorDebugProcess object that represents the process containing the connection that changed.

  • dwConnectionId
    [in] The ID of the connection that changed.

Remarks

A ChangeConnection callback will be fired in either of the following cases:

  • When a debugger attaches to a process that contains connections. In this case, the runtime will generate and dispatch a ICorDebugManagedCallback2::CreateConnection event and a ChangeConnection event for each connection in the process. A ChangeConnection event is generated for every existing connection, regardless of whether that connection’s set of tasks has been changed since its creation.

  • When a host calls ICLRDebugManager::SetConnectionTasks in the Hosting API.

The debugger should scan all threads in the process to pick up the new changes.

Requirements

Platforms: See .NET Framework System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

See Also

Reference

ICorDebugManagedCallback2 Interface

ICorDebugManagedCallback Interface