共用方式為

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 起提供

另請參閱