Método ITaskHandler::Start (taskschd.h)

Chamado para iniciar o manipulador COM. Esse método deve ser implementado pelo manipulador.

Sintaxe

HRESULT Start(
  [in] IUnknown *pHandlerServices,
  [in] BSTR     data
);

Parâmetros

[in] pHandlerServices

Uma interface IUnkown usada para se comunicar novamente com o Agendador de Tarefas.

[in] data

Os argumentos exigidos pelo manipulador. Esses argumentos são definidos na propriedade Data da ação do manipulador COM.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Ao implementar esse método, o manipulador deve retornar o controle imediatamente para o Agendador de Tarefas (iniciando seu próprio thread, se inproc).

Depois que o manipulador iniciar seu processamento, ele poderá chamar o método UpdateStatus para indicar seu percentual de conclusão ou chamar o método TaskCompleted para indicar quando o manipulador concluiu seu processamento. Esses métodos são fornecidos pela interface ITaskHandlerStatus .

Requisitos

Confira também

Dados

ITaskHandler

ITaskHandlerStatus

Agendador de Tarefas

TaskCompleted

UpdateStatus