Поделиться через

Метод ICLRDebugManager::BeginConnection

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

Синтаксис

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

Параметры

dwConnectionId
[in] Идентификатор для связи со списком задач среды CLR.

szConnectionName
[in] Понятное имя, связываемое со списком задач СРЕДЫ CLR.

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

HRESULT Описание:
S_OK BeginConnection возвращается успешно.
HOST_E_CLRNOTAVAILABLE Среда CLR не была загружена в процесс или среда 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 предоставляет три метода, BeginConnectionSetConnectionTasks и EndConnection, для связывания списков задач с идентификаторами и понятными именами.

Важно!

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

Требования

Платформы: см. раздел Требования к системе.

Заголовка: MSCorEE.h

Библиотека: Включено в качестве ресурса в MSCorEE.dll

версии платформа .NET Framework: доступно с версии 2.0

См. также раздел

  • Last updated on