Metodo IScheduledWorkItem::GetRunTimes (mstask.h)

[[Questa API può essere modificata o non disponibile nelle versioni successive del sistema operativo o del prodotto. Usare invece le interfacce dell'Utilità di pianificazione 2.0 . ]

Recupera i tempi di esecuzione dell'elemento di lavoro per un periodo di tempo specificato.

Sintassi

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

Parametri

[in] pstBegin

Puntatore a una struttura SYSTEMTIME che contiene l'ora di inizio del periodo di tempo da controllare. Questo valore è inclusivo.

[in] pstEnd

Puntatore a una struttura SYSTEMTIME che contiene l'ora di fine del periodo di tempo da controllare. Questo valore è esclusivo. Se viene passato NULL per questo valore, l'ora di fine è infinita.

[in, out] pCount

Puntatore a un valore di WORD che specifica il numero di esecuzioni da recuperare.

In input, questo parametro contiene il numero di esecuzioni richieste. Può trattarsi di un numero compreso tra 1 e TASK_MAX_RUN_TIMES.

Nell'output questo parametro contiene il numero di tempi di esecuzione recuperati.

[out] rgstTaskTimes

Puntatore a una matrice di strutture SYSTEMTIME . 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

Il metodo GetRunTimes restituisce uno dei valori seguenti.

Requisiti

Vedi anche

IScheduledWorkItem