Skip to content

Latest commit

 

History

History
64 lines (46 loc) · 2.28 KB

icordebugmanagedcallback2-changeconnection-method.md

File metadata and controls

64 lines (46 loc) · 2.28 KB
description title ms.date api_name api_location api_type f1_keywords helpviewer_keywords ms.assetid topic_type
Learn more about: ICorDebugManagedCallback2::ChangeConnection Method
ICorDebugManagedCallback2::ChangeConnection Method
03/30/2017
ICorDebugManagedCallback2.ChangeConnection
mscordbi.dll
COM
ICorDebugManagedCallback2::ChangeConnection
ICorDebugManagedCallback2::ChangeConnection method [.NET Framework debugging]
ChangeConnection method [.NET Framework debugging]
7263f9a9-4c0b-4d82-a181-288873fb2b18
apiref

ICorDebugManagedCallback2::ChangeConnection Method

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

Syntax

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 System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: [!INCLUDEnet_current_v20plus]

See also