ICLRDebugManager::BeginConnection 方法

在主應用程式和偵錯工具之間建立新的連接，將工作清單與識別項和易記名稱產生關聯。

HRESULT BeginConnection (
    [in] CONNID dwConnectionId,
    [in, string] wchar_t* szConnectionName
);

參數

HRESULT	描述
S_OK	BeginConnection 已成功傳回。
HOST_E_CLRNOTAVAILABLE	CLR 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。
HOST_E_TIMEOUT	呼叫已逾時。
HOST_E_NOT_OWNER	呼叫端不具備鎖定功能。
HOST_E_ABANDONED	已封鎖執行緒或 Fiber 在等候事件時，該事件已遭取消。
E_FAIL	發生未知的重大錯誤。在方法傳回 E_FAIL 之後，處理序中就無法再使用 CLR。對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。
E_INVALIDARG	dwConnectionId 為零，或是已經使用此 dwConnectionId 值呼叫 BeginConnection，或是 szConnectionName 為 null。
E_OUTOFMEMORY	可以配置的記憶體不足，無法保存與此連接有關聯的工作清單。

ICLRDebugManager 提供三個方法 (亦即 BeginConnection、SetConnectionTasks 和 EndConnection)，將工作清單與識別項和易記名稱產生關聯。

重要事項
每一組工作集都必須按照其特定順序來呼叫這三個方法。首先，它會呼叫 BeginConnection 來建立新的連接，接著呼叫 SetConnectionTasks 以提供要與該連接相關聯的工作集，最後再呼叫 EndConnection 來移除工作清單以及識別項和易記名稱之間的關聯。但是，不同連接的呼叫可以是巢狀結構。