ICLRDebugManager::BeginConnection 方法

在宿主与调试器之间建立新连接，以便将任务列表与标识符和友好名称关联起来。

HRESULT BeginConnection (
    [in] CONNID dwConnectionId,
    [in, string] wchar_t* szConnectionName
);

参数

HRESULT	说明
S_OK	BeginConnection 已成功返回。
HOST_E_CLRNOTAVAILABLE	CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。
HOST_E_TIMEOUT	调用超时。
HOST_E_NOT_OWNER	调用方不拥有锁。
HOST_E_ABANDONED	事件在被阻止的线程或纤程正在等待它时被取消。
E_FAIL	发生了未知的灾难性故障。在某方法返回 E_FAIL 后，CLR 便无法再在进程中使用。对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。
E_INVALIDARG	dwConnectionId 为零，或者已使用此 dwConnectionId 值调用 BeginConnection，或者 szConnectionName 为 Null。
E_OUTOFMEMORY	无法分配足够的内存来保存与此连接关联的任务列表。

ICLRDebugManager 提供了三个方法（BeginConnection、SetConnectionTasks 和 EndConnection），用于将任务列表与标识符和友好名称关联起来。

重要事项
对于每组任务，必须按特定顺序调用这三个方法。首先调用 BeginConnection 来建立一个新连接。接着调用 SetConnectionTasks 以提供要与该连接关联的一组任务。最后调用 EndConnection 以移除任务列表与标识符和友好名称之间的关联。但是，可以嵌套不同连接的调用。