Метод ICLRDebugManager::BeginConnection

Статья
11/16/2008

Обновлен: Ноябрь 2007

Задает новое соединение между основным приложением и отладчиком, чтобы связать список задач с идентификатором и понятным именем.

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

Параметры

dwConnectionId
[in] Идентификатор, который необходимо связать со списком задач среды CLR.
szConnectionName
[in] Понятное имя, которое необходимо связать со списком задач среды CLR.

Возвращаемое значение

HRESULT	Описание
S_OK	Метод BeginConnection успешно возвратил значение.
HOST_E_CLRNOTAVAILABLE	Среда CLR не загружена в процесс или находится в состоянии, в котором ей не удается выполнить управляемый код или успешно обработать вызов.
HOST_E_TIMEOUT	Время ожидания вызова истекло.
HOST_E_NOT_OWNER	Вызывающий объект не владеет блокировкой.
HOST_E_ABANDONED	Событие, которого ожидал заблокированный поток или нить, было отменено.
E_FAIL	Произошел неизвестный разрушительный сбой. После того как метод вернет значение E_FAIL, среду CLR более нельзя будет использовать в данном процессе. Последующие вызовы методов размещения возвращают значение HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	Значение параметра dwConnectionId было равно нулю, метод BeginConnection уже был вызван с использованием этого значения dwConnectionId или значение параметра szConnectionName было равно NULL.
E_OUTOFMEMORY	Не удается выделить достаточное количество памяти для размещения в ней списка задач, связанного с этим соединением.

Заметки

Интерфейс ICLRDebugManager предоставляет три метода: BeginConnection, SetConnectionTasks и EndConnection, позволяющие связать списки задач с идентификаторами и понятными именами.

Важное примечание.
Эти три метода следует вызывать в определенном порядке для каждого набора задач. Сначала вызывается метод BeginConnection, чтобы задать новое подключение. Затем вызывается метод SetConnectionTasks для предоставления набора задач, которые необходимо связать с подключением. В конце вызывается метод EndConnection, для удаления связи между списком задач и идентификатором и понятным именем. Однако вызовы других подключений могут быть вложенными.

Эти три метода следует вызывать в определенном порядке для каждого набора задач. Сначала вызывается метод BeginConnection, чтобы задать новое подключение. Затем вызывается метод SetConnectionTasks для предоставления набора задач, которые необходимо связать с подключением. В конце вызывается метод EndConnection, для удаления связи между списком задач и идентификатором и понятным именем. Однако вызовы других подключений могут быть вложенными.