ICorDebugManagedCallback2::CreateConnection Method

Notifies the debugger that a new connection has been created.

Syntax

HRESULT CreateConnection (  
    [in] ICorDebugProcess     *pProcess,  
    [in] CONNID               dwConnectionId,  
    [in] WCHAR                *pConnName  
);  

Parameters

pProcess
[in] A pointer to an "ICorDebugProcess" object that represents the process in which the connection was created

dwConnectionId
[in] The ID of the new connection.

pConnName
[in] A pointer to the name of the new connection.

Remarks

A CreateConnection 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 CreateConnection event and a ICorDebugManagedCallback2::ChangeConnection event for each connection in the process.

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

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0

See also

• ICorDebugManagedCallback2 Interface
• ICorDebugManagedCallback Interface