通过

ICLRDebugManager::SetConnectionTasks 方法

  • 项目

将 ICLRTask 实例列表与标识符和友好名称关联。

语法

HRESULT SetConnectionTasks (  
    [in] CONNID id,  
    [in] DWORD dwCount,  
    [in, size_is(dwCount)] ICLRTask **ppCLRTask  
);

参数

id
[in] 要与 ppCLRTask 数组关联的连接的主机特定标识符。

dwCount
[in] ppCLRTask 的成员数量。 数量必须大于零。

ppCLRTask
[in] 要与 id 标识的连接关联的 ICLRTask 指针数组。 数组内必须至少包含一名成员。

返回值

HRESULT 说明
S_OK 已成功返回 SetConnectionTasks。
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 尚未使用此 id 值调用 BeginConnection，或 dwCount 或 id 为零，或 ppCLRTask 的其中一个元素为 null。

注解

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

重要

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

要求

平台：请参阅系统要求。

标头：MSCorEE.h

库：作为资源包含在 MSCorEE.dll 中

.NET Framework 版本：自 2.0 起可用

另请参阅