Partager 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: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Concepts

ICorDebugManagedCallback2 Interface

ICorDebugManagedCallback Interface