Метод IHostTaskManager::CreateTask
Запрашивает создание новой задачи основным приложением.
HRESULT CreateTask (
[in] DWORD stacksize,
[in] LPTHREAD_START_ROUTINE pStartAddress,
[in] PVOID pParameter,
[out] IHostTask **ppTask
);
Параметры
stacksize
[in] Запрашиваемый размер требуемого стека (в байтах) или нуль (0) для значения по умолчанию.pStartAddress
[in] Указатель на функцию, которую должна выполнить задача.pParameter
[in] Указатель на передаваемые функции пользовательские данные или NULL, если функция не принимает параметры.ppTask
[out] Указатель на адрес экземпляра IHostTask, созданного основным приложением или NULL, если не удается создать задачу. Задача остается в приостановленном состоянии, до тех пор, пока не будет явным образом запущена в результате вызова IHostTask::Start.
Возвращаемое значение
HRESULT |
Описание |
|---|---|
S_OK |
Метод CreateTask успешно возвратил значение. |
HOST_E_CLRNOTAVAILABLE |
Среда CLR не загружена в процесс или находится в состоянии, в котором ей не удается выполнить управляемый код или успешно обработать вызов. |
HOST_E_TIMEOUT |
Время ожидания вызова истекло. |
HOST_E_NOT_OWNER |
Вызывающий объект не владеет блокировкой. |
HOST_E_ABANDONED |
Событие, которого ожидал заблокированный поток или нить, было отменено. |
E_FAIL |
Произошел неизвестный разрушительный сбой. Если метод вернет значение E_FAIL, среду CLR более нельзя будет использовать в данном процессе. Последующие вызовы методов размещения возвращают значение HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY |
Недостаточно памяти для создания запрошенной задачи. |
Заметки
Среда CLR вызывает метод CreateTask для запроса создания новой задачи основным приложением. Основное приложение возвращает указатель интерфейса на экземпляр IHostTask. Возвращаемая задача должна оставаться приостановленной, до тех пор, пока она не будет запущена явным образом путем вызова метода IHostTask::Start.
Требования
Платформы: см. раздел Требования к системе для .NET Framework.
Заголовок: MSCorEE.h
Библиотека: включена как ресурс в MSCorEE.dll
Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0