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] ICLRTask 指標陣列，要與 id 所識別的連線產生關聯。 此陣列至少必須包含一個成員。
傳回值
| HRESULT | 描述 |
|---|---|
| S_OK | SetConnectionTasks 已成功傳回。 |
| HOST_E_CLRNOTAVAILABLE | 通用語言執行平台 (CLR) 尚未載入處理序，或 CLR 處於無法成功執行受控程式碼或處理呼叫的狀態。 |
| HOST_E_TIMEOUT | 呼叫逾時。 |
| HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
| HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。 |
| 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 起提供
