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 起可用

另请参阅