Metodo IScheduledWorkItem::SetIdleWait (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 . ]
Imposta i minuti che il sistema deve essere inattiva prima che l'elemento di lavoro possa essere eseguito.
Sintassi
HRESULT SetIdleWait(
[in] WORD wIdleMinutes,
[in] WORD wDeadlineMinutes
);
Parametri
[in] wIdleMinutes
Valore che specifica quanto tempo, in minuti, il sistema deve rimanere inattiva prima che l'elemento di lavoro possa essere eseguito.
[in] wDeadlineMinutes
Valore che specifica il numero massimo di minuti che l'utilità di pianificazione attenderà il periodo di inattività restituito in pwIdleMinutes.
Valore restituito
Il metodo SetIdleWait restituisce S_OK.
Commenti
Il tempo di inattività specificato qui viene usato in combinazione con trigger inattive e condizioni di inattività. Per altre informazioni, vedere Condizioni di inattività attività. I trigger inattive sono trigger basati su eventi che non sono associati a un'ora pianificata. Le condizioni inattive, al contrario, sono associate all'ora di inizio pianificata per l'attività.
Specificare i trigger inattivi impostando il membro TASK_TRIGGER_TYPE dell'TASK_TRIGGER su TASK_EVENT_TRIGGER_ON_IDLE. Il trigger inattiva viene attivato quando il sistema diventa inattiva per la quantità di tempo specificata da wIdleMinutes.
È possibile impostare le condizioni di inattività chiamando IScheduledWorkItem::SetFlags. Se il flag TASK_FLAG_START_ONLY_IF_IDLE è impostato, l'elemento di lavoro viene eseguito all'ora pianificata solo se il sistema diventa inattiva per la quantità di tempo specificata da wIdleMinutes. Il servizio Utilità di pianificazione attende fino al numero di minuti specificati in wDeadlineMinutes dopo l'ora di inizio pianificata per verificare se il sistema diventa inattiva.
Le applicazioni devono chiamare il metodo IPersistFile::Save dopo aver chiamato SetIdleWait per aggiornare l'intervallo di attesa inattivo.
Esempio
Per un esempio di come impostare il tempo di attesa inattiva durante la creazione di un trigger inattiva, vedere Creazione di un esempio di trigger inattiva.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mstask.h |
| Libreria | Mstask.lib |
| DLL | Mstask.dll |
| Componente ridistribuibile | Internet Explorer 4.0 o versione successiva in Windows NT 4.0 e Windows 95 |