Метод ICLRDebugManager::SetConnectionTasks

Статья
11/16/2008

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

Связывает список экземпляров ICLRTask с идентификатором и понятным именем.

HRESULT SetConnectionTasks (
    [in] CONNID id,
    [in] DWORD dwCount,
    [in, size_is(dwCount)] ICLRTask **ppCLRTask
);

Параметры

id
[in] Особый идентификатор основного приложения, для соединения с которым нужно связать массив ppCLRTask.
dwCount
[in] Количество элементов в параметре ppCLRTask. Это число должно быть больше нуля.
ppCLRTask
[in] Массив указателей ICLRTask, которые необходимо связать с соединением, заданным параметром id. Этот массив должен содержать, по меньшей мере, один член.

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

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

Заметки

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

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

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