Método IRegisteredTask::GetRunTimes (taskschd.h)

Obtém os horários em que a tarefa registrada está agendada para ser executada durante um período especificado.

Sintaxe

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstStart,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] DWORD              *pCount,
  [out]     LPSYSTEMTIME       *pRunTimes
);

Parâmetros

[in] pstStart

A hora de início da consulta.

[in] pstEnd

A hora final da consulta.

[in, out] pCount

O número solicitado de execuções na entrada e o número retornado de execuções na saída.

[out] pRunTimes

Os horários agendados que a tarefa executará. Um objeto LPSYSTEMTIME NULL deve ser passado para esse parâmetro. No retorno, essa matriz contém tempos de execução de pCount . Você deve liberar essa matriz chamando a função CoTaskMemFree .

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se o método retornar S_FALSE, o parâmetro pRunTimes conterá itens pCount, mas houver mais execuções da tarefa, que não foram retornadas. Caso contrário, ela retornará um código de erro HRESULT.

Comentários

Se a tarefa registrada contiver gatilhos que são desabilitados individualmente, esses gatilhos ainda afetarão o próximo tempo de execução agendado retornado mesmo que estejam desabilitados.

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

Confira também

IRegisteredTask

Agendador de Tarefas