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

Vedi anche

IScheduledWorkItem

IScheduledWorkItem::GetIdleWait