TASK_TRIGGER struttura (mstask.h)

Articolo
08/25/2023

Definisce i tempi per eseguire un elemento di lavoro pianificato.

Sintassi

typedef struct _TASK_TRIGGER {
  WORD               cbTriggerSize;
  WORD               Reserved1;
  WORD               wBeginYear;
  WORD               wBeginMonth;
  WORD               wBeginDay;
  WORD               wEndYear;
  WORD               wEndMonth;
  WORD               wEndDay;
  WORD               wStartHour;
  WORD               wStartMinute;
  DWORD              MinutesDuration;
  DWORD              MinutesInterval;
  DWORD              rgFlags;
  TASK_TRIGGER_TYPE  TriggerType;
  TRIGGER_TYPE_UNION Type;
  WORD               Reserved2;
  WORD               wRandomMinutesInterval;
} TASK_TRIGGER, *PTASK_TRIGGER;

Members

cbTriggerSize

Dimensioni di questa struttura, in byte.

Reserved1

Solo per l'uso interno; questo valore deve essere zero.

wBeginYear

Anno in cui viene attivato il trigger dell'attività. Questo valore deve essere quattro cifre (1997, non 97). L'anno iniziale deve essere specificato quando si imposta un'attività.

wBeginMonth

Mese dell'anno (specificato nel membro wBeginYear ) attivato dall'attività. Il mese iniziale deve essere specificato quando si imposta un'attività.

wBeginDay

Giorno del mese (specificato nel membro wBeginMonth ) attivato dal trigger attività. Il giorno iniziale deve essere specificato quando si imposta un'attività.

wEndYear

Anno in cui il trigger dell'attività disattiva. Questo valore deve essere quattro cifre (1997, non 97).

wEndMonth

Mese dell'anno (specificato nel membro wEndYear ) disattivato dall'attività.

wEndDay

Giorno del mese (specificato nel membro wEndMonth ) disattivato dal trigger attività.

wStartHour

Ora del giorno in cui viene eseguita l'attività. Questo valore è su un orologio di 24 ore; ore vanno da 00 a 23.

wStartMinute

Minuto dell'ora (specificato nel membro wStartHour ) eseguito dall'attività.

MinutesDuration

Numero di minuti dopo l'avvio dell'attività che il trigger rimarrà attivo. Il numero di minuti specificato qui deve essere maggiore o uguale all'impostazione MinutesInterval .

Ad esempio, se si avvia un'attività alle 8:00 A.M. e si vuole avviare ripetutamente l'attività fino alle 5:00, nella durata saranno presenti 540 minuti.

MinutesInterval

Numero di minuti tra esecuzioni di attività consecutive. Questo numero viene conteggiato dall'inizio dell'attività pianificata precedente. Il numero di minuti specificato qui deve essere minore dell'impostazione MinutesDuration .

Ad esempio, per eseguire un'attività ogni ora dalle 8:00 a 5:00 P.M., impostare questo campo su 60.

rgFlags

Valore che descrive il comportamento del trigger. Questo valore è una combinazione dei flag seguenti.

TASK_TRIGGER_FLAG_HAS_END_DATE

La data di fine della struttura del trigger è valida. Se questo flag non è impostato, i dati della data di fine vengono ignorati e il trigger sarà valido in modo indefinito.

TASK_TRIGGER_FLAG_KILL_AT_DURATION_END

L'attività verrà terminata alla fine della durata del trigger attivo. Al termine della durata, l'utilità di pianificazione invia un messaggio WM_CLOSE all'applicazione associata. Se non è possibile inviare WM_CLOSE (ad esempio, l'applicazione non ha finestre) o l'applicazione non è stata chiusa entro tre minuti dalla ricezione WM_CLOSE, l'utilità di pianificazione termina l'applicazione usando TerminateProcess.

TASK_TRIGGER_FLAG_DISABLED

Il trigger attività è inattivo.

TriggerType

Valore TASK_TRIGGER_TYPE enumerato che specifica il tipo di trigger. Questo membro viene usato con Type. Il tipo di trigger specificato qui determina quali campi del TRIGGER_TYPE_UNION specificato nel membro Type verranno usati. Il tipo di trigger si basa su quando il trigger eseguirà l'attività.

Type

Struttura TRIGGER_TYPE_UNION che specifica i dettagli sul trigger. Si noti che il membro TriggerType determina quali campi dell'unione TRIGGER_TYPE_UNION verranno usati.

Reserved2

Solo per l'uso interno; questo valore deve essere zero.

wRandomMinutesInterval

Attualmente non utilizzato.

Commenti

Questi orari possono includere l'ora di inizio, l'ora di fine, la durata e i flag di modifica per l'elemento di lavoro. Si noti che quando si imposta un trigger, è necessario impostare il mese e l'anno di inizio giorno.

Nota Un elemento di lavoro pianificato può avere uno o più trigger definiti. I tempi di esecuzione dell'elemento di lavoro sono l'unione di tutti i trigger definiti per tale elemento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	mstask.h