ICLRDebugManager::BeginConnection 方法
在主機與偵錯工具之間建立新連線，以便讓工作清單與識別碼和自訂名稱產生關聯。
語法
HRESULT BeginConnection (
[in] CONNID dwConnectionId,
[in, string] wchar_t* szConnectionName
);
參數
dwConnectionId
[in] 要與 Common Language Runtime (CLR) 工作清單產生關聯的識別碼。
szConnectionName
[in] 要與 CLR 工作清單產生關聯的自訂名稱。
傳回值
| HRESULT | 描述 |
|---|---|
| S_OK | BeginConnection 已成功傳回。 |
| 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 | dwConnectionId 為零，或 BeginConnection 已使用此 dwConnectionId 值呼叫，或 szConnectionName 為 null。 |
| E_OUTOFMEMORY | 記憶體不足，無法配置來保存與此連線相關聯的工作清單。 |
備註
ICLRDebugManager 提供三個方法 (BeginConnection、SetConnectionTasks 和 EndConnection) 來將工作清單與識別碼和自訂名稱產生關聯。
重要
這三個方法必須依每個工作集的特定順序進行呼叫。 會先呼叫 BeginConnection 以建立新的連線。 接著會呼叫 SetConnectionTasks 以提供要與該連線產生關聯的工作集。 最後會呼叫 EndConnection 以移除工作清單與識別碼和自訂名稱之間的關聯。不過，不同連線的呼叫可以巢狀化。
規格需求
平台：請參閱系統需求。
標題： MSCorEE.h
程式庫：包含作為 MSCorEE.dll 中的資源
.NET Framework版本：自 2.0 起提供
