Metodo IScheduledWorkItem::GetIdleWait (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 il tempo di attesa inattiva per l'elemento di lavoro.

Per informazioni sulle condizioni di inattività, vedere Condizioni di inattività attività.

Sintassi

HRESULT GetIdleWait(
  [out] WORD *pwIdleMinutes,
  [out] WORD *pwDeadlineMinutes
);

Parametri

[out] pwIdleMinutes

Puntatore a un word contenente il tempo di attesa inattiva per l'elemento di lavoro corrente, in minuti.

[out] pwDeadlineMinutes

Puntatore a word che specifica il numero massimo di minuti che l'utilità di pianificazione attenderà il periodo di inattività restituito in pwIdleMinutes.

Valore restituito

Il metodo GetIdleWait restituisce uno dei valori seguenti.

Commenti

Il tempo di inattività restituito qui viene usato insieme a trigger inattive e condizioni di inattività. I trigger inattive sono trigger basati su eventi che non sono associati a un'ora pianificata. Le condizioni di inattività sono associate all'ora di inizio pianificata per l'attività.

I trigger inattive vengono specificati impostando il membro TASK_TRIGGER_TYPE della strutturaTASK_TRIGGER sul valore TASK_EVENT_TRIGGER_ON_IDLE. Il trigger inattiva viene attivato quando il sistema diventa inattiva per la quantità di tempo restituita in pwIdleMinutes.

È possibile impostare condizioni di inattività chiamando IScheduledWorkItem::SetFlags. Se il flag di TASK_FLAG_START_ONLY_IF_IDLE è impostato, l'elemento di lavoro viene eseguito all'ora pianificata solo se il sistema diventa inattiva per il tempo restituito in pwIdleMinutes. Il servizio Utilità di pianificazione attende fino a pwDeadlineMinutes dopo l'ora di inizio pianificata per verificare se il sistema diventa inattiva.

Esempio

Per un esempio di come recuperare il tempo di attesa inattiva di un'attività, vedere Esempio di codice C/C++: Recupero dell'ora di attesa dell'attività.

Requisiti

Vedi anche

IScheduledWorkItem

IScheduledWorkItem::SetIdleWait