Метод ICLRTaskManager::CreateTask
Явно запрашивает, чтобы среда CLR (CLR) создавала новую задачу.
Синтаксис
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Параметры
pTask
[out] Указатель на адрес созданного объекта ICLRTask или null, если не удалось создать задачу.
Возвращаемое значение
| HRESULT | Описание: |
|---|---|
| S_OK | Метод возвратился успешно. |
| HOST_E_CLRNOTAVAILABLE | Среда CLR не была загружена в процесс или среда CLR находится в состоянии, в котором она не может выполнить управляемый код или обработать вызов. |
| HOST_E_TIMEOUT | Истекло время ожидания звонка. |
| HOST_E_NOT_OWNER | Вызывающий объект не является владельцем блокировки. |
| HOST_E_ABANDONED | Событие было отменено во время ожидания заблокированного потока или волокна. |
| E_FAIL | Произошла неизвестная катастрофическая ошибка. Когда метод возвращает E_FAIL, среда CLR больше не поддерживается в процессе. Последующие вызовы методов размещения возвращают HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Недостаточно памяти для выделения запрошенного ресурса. |
Комментарии
Среда CLR автоматически создает новую задачу после инициализации, когда пользовательский код создает поток с помощью типов в System.Threading пространстве имен или при увеличении размера пула потоков. Он также создает задачи, когда неуправляемый код выполняет вызов управляемой функции.
CreateTask позволяет узлу выполнить явный запрос на создание новой задачи средой CLR. Например, узел может вызвать этот метод для предварительной инициализации структур данных.
Важно!
Новая задача возвращается в приостановленном состоянии и остается приостановленной до тех пор, пока узел явно не вызовет IHostTask::Start.
Требования
Платформы: см. раздел Требования к системе.
Заголовка: MSCorEE.h
Библиотека: Включено в качестве ресурса в MSCorEE.dll
версии платформа .NET Framework: доступно с версии 2.0
