Método IScheduledWorkItem::GetRunTimes (mstask.h)

Artigo
02/29/2024

[[Essa API pode estar alterada ou indisponível em versões subsequentes do sistema operacional ou produto. Em vez disso, use as Interfaces do Agendador de Tarefas 2.0 .] ]

Recupera os tempos de execução do item de trabalho para um período de tempo especificado.

Sintaxe

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstBegin,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] WORD               *pCount,
  [out]     LPSYSTEMTIME       *rgstTaskTimes
);

Parâmetros

[in] pstBegin

Um ponteiro para uma estrutura SYSTEMTIME que contém a hora de início do período de tempo a ser marcar. Esse valor é inclusivo.

[in] pstEnd

Um ponteiro para uma estrutura SYSTEMTIME que contém a hora final do período de tempo a ser marcar. Esse valor é exclusivo. Se NULL for passado para esse valor, a hora de término será infinita.

[in, out] pCount

Um ponteiro para um valor WORD que especifica o número de tempos de execução a serem recuperados.

Na entrada, esse parâmetro contém o número de tempos de execução que estão sendo solicitados. Isso pode ser um número entre 1 e TASK_MAX_RUN_TIMES.

Na saída, esse parâmetro contém o número de tempos de execução recuperados.

[out] rgstTaskTimes

Um ponteiro para uma matriz de estruturas SYSTEMTIME . 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

O método GetRunTimes retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	O número solicitado de tempos de execução foi recuperado.
S_FALSE	O método foi bem-sucedido, mas menos do que o número solicitado de tempos de execução foram recuperados. O número de tempos de execução recuperados está contido no valor apontado por pCount. Se o número de tempos de execução recuperados for zero, também não haverá gatilhos baseados em evento que possam fazer com que o item de trabalho seja executado durante o período de tempo especificado.
SCHED_S_TASK_NO_VALID_TRIGGERS	O item de trabalho está habilitado, mas não tem gatilhos válidos.
SCHED_S_TASK_DISABLED	O item de trabalho está desabilitado.
E_INVALIDARG	Um ou mais argumentos são inválidos.
E_OUTOFMEMORY	Não há memória suficiente para calcular o resultado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mstask.h
Biblioteca	Mstask.lib
DLL	Mstask.dll
Redistribuível	Internet Explorer 4.0 ou posterior no Windows NT 4.0 e Windows 95

Confira também

IScheduledWorkItem

Compartilhar via