Método IHostTaskManager::CreateTask

Artigo
08/25/2010

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 dimensionar solicitado, em bytes, da pilha solicitada ou 0 (zero) para o dimensionar padrão.
pStartAddress
[in] Um ponteiro para a função a tarefa é executada.
pParameter
[in] Um ponteiro para os dados do usuário a ser passada para a função ou nulo caso a função use sem parâmetros.
ppTask
[out] Um ponteiro para o endereço de um IHostTask instância criada pelo host ou nula se a tarefa não pode ser criada. A tarefa permanece em um estado suspenso até que ele seja iniciado por uma telefonar para explicitamenteIHostTask::Start.

Valor de retorno

HRESULT	Descrição
S_OK	CreateTask retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não há memória insuficiente criar a tarefa solicitada.

Comentários

O CLR chama CreateTask para solicitar que o host crie 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 iniciado por uma telefonar para explicitamenteIHostTask::Start.