Método de IHostTaskManager::CreateTask

Artigo
08/08/2011

Solicitações que o host crie uma nova tarefa.

HRESULT CreateTask (
    [in]  DWORD stacksize, 
    [in]  LPTHREAD_START_ROUTINE pStartAddress,
    [in]  PVOID pParameter,
    [out] IHostTask **ppTask
);

Parâmetros

stacksize
[in] O tamanho solicitado, em bytes, da pilha solicitada ou 0 (zero) para o tamanho padrão.
pStartAddress
[in] Um ponteiro para a função a tarefa é executada.
pParameter
[in] Um ponteiro para os dados a serem passados para a função, ou null se a função do usuário sem parâmetros.
ppTask
[out] Um ponteiro para o endereço de um IHostTask instância criada pelo host ou null se a tarefa não pode ser criada. A tarefa permanece em um estado suspenso até que ele seja explicitamente iniciado por uma chamada para IHostTask::Start.

Valor de retorno

HRESULT	Descrição
S_OK	CreateTaskretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não havia memória disponível suficiente para criar a tarefa solicitada.

Comentários

As chamadas CLR CreateTask para solicitar que o host é criar uma nova tarefa. O host retorna um ponteiro de interface para um IHostTask instância. A tarefa retornada deve permanecer suspensa até que ele seja explicitamente iniciado por uma chamada para IHostTask::Start.