Metodo IRegisteredTask::GetRunTimes (taskschd.h)

Ottiene le ore in cui è pianificata l'esecuzione dell'attività registrata durante un periodo di tempo specificato.

Sintassi

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

Parametri

[in] pstStart

Ora di inizio della query.

[in] pstEnd

Ora di fine della query.

[in, out] pCount

Numero richiesto di esecuzioni sull'input e numero restituito di esecuzioni nell'output.

[out] pRunTimes

Orari pianificati in cui verrà eseguita l'attività. A questo parametro deve essere passato un oggetto LPSYSTEMTIME NULL . In caso di restituzione, questa matrice contiene i tempi di esecuzione pCount . È necessario liberare questa matrice chiamando la funzione CoTaskMemFree .

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se il metodo restituisce S_FALSE, il parametro pRunTimes contiene elementi pCount, ma sono state eseguite più esecuzioni dell'attività, che non sono state restituite. In caso contrario, restituisce un codice di errore HRESULT.

Commenti

Se l'attività registrata contiene trigger che sono disabilitati singolarmente, questi trigger avranno comunque effetto sul successivo tempo di esecuzione pianificato restituito anche se sono disabilitati.

Requisiti

Vedi anche

IRegisteredTask

Utilità di pianificazione