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

Artigo
03/02/2024

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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	taskschd.h
Biblioteca	Taskschd.lib
DLL	Taskschd.dll