Метод 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
