ICorDebugManagedCallback2::CreateConnection Method

Article
09/15/2021

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