ICLRDebugManager::BeginConnection 方法
在主机和调试器之间建立新连接，以将任务列表与标识符和友好名称关联。
语法
HRESULT BeginConnection (
[in] CONNID dwConnectionId,
[in, string] wchar_t* szConnectionName
);
参数
dwConnectionId
[in] 要与公共语言运行时 (CLR) 任务列表关联的标识符。
szConnectionName
[in] 要与 CLR 任务列表关联的友好名称。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 已成功返回 BeginConnection。 |
| HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中，或 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，清除任务列表与标识符和友好名称之间的关联。但是，可以嵌套对其他连接的调用。
要求
平台：请参阅系统要求。
标头：MSCorEE.h
库：作为资源包含在 MSCorEE.dll 中
.NET Framework 版本：自 2.0 起可用
