TASK_TRIGGER 구조체(mstask.h)
예약된 작업 항목을 실행하는 시간을 정의합니다.
구문
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;
멤버
cbTriggerSize
이 구조체의 크기(바이트)입니다.
Reserved1
내부용으로만 사용; 이 값은 0이어야 합니다.
wBeginYear
작업 트리거가 활성화되는 연도입니다. 이 값은 4자리 숫자여야 합니다(97이 아닌 1997). 작업을 설정할 때 시작 연도를 지정해야 합니다.
wBeginMonth
작업 트리거가 활성화하는 연도의 월( wBeginYear 멤버에 지정됨)입니다. 작업을 설정할 때 시작 월을 지정해야 합니다.
wBeginDay
작업 트리거가 활성화되는 월의 일( wBeginMonth 멤버에 지정됨)입니다. 작업을 설정할 때 시작 날짜를 지정해야 합니다.
wEndYear
작업 트리거가 비활성화되는 연도입니다. 이 값은 4자리 숫자여야 합니다(97이 아닌 1997).
wEndMonth
작업 트리거가 비활성화하는 연도의 월( wEndYear 멤버에 지정됨)입니다.
wEndDay
작업 트리거가 비활성화하는 월의 일( wEndMonth 멤버에 지정됨)입니다.
wStartHour
작업이 실행되는 시간의 시간입니다. 이 값은 24시간 시계에 있습니다. 시간은 00에서 23으로 이동합니다.
wStartMinute
작업이 실행되는 시간( wStartHour 멤버에 지정됨)의 분입니다.
MinutesDuration
작업이 시작된 후 트리거가 활성 상태로 유지되는 시간(분)입니다. 여기에 지정된 분 수는 MinutesInterval 설정보다 크거나 같아야 합니다.
예를 들어 오전 8시에 작업을 시작하고 오후 5시까지 작업을 반복적으로 시작하려는 경우 해당 기간에는 540분이 소요됩니다.
MinutesInterval
연속된 작업 실행 사이의 시간(분)입니다. 이 숫자는 이전 예약된 작업의 시작부터 계산됩니다. 여기에 지정된 분 수는 MinutesDuration 설정보다 작아야 합니다.
예를 들어 오전 8시에서 오후 5시까지 매시간 작업을 실행하려면 이 필드를 60으로 설정합니다.
rgFlags
트리거의 동작을 설명하는 값입니다. 이 값은 다음 플래그의 조합입니다.
TASK_TRIGGER_FLAG_HAS_END_DATE
트리거 구조의 종료 날짜가 유효합니다. 이 플래그를 설정하지 않으면 종료 날짜 데이터가 무시되고 트리거가 무기한 유효합니다.
TASK_TRIGGER_FLAG_KILL_AT_DURATION_END
작업은 활성 트리거의 수명이 끝날 때 종료됩니다. 기간이 끝나면 작업 스케줄러는 연결된 애플리케이션에 WM_CLOSE 메시지를 보냅니다. WM_CLOSE 보낼 수 없거나(예: 애플리케이션에 창이 없음) 수신 WM_CLOSE 3분 이내에 애플리케이션이 종료되지 않은 경우 작업 스케줄러는 TerminateProcess를 사용하여 애플리케이션을 종료합니다.
TASK_TRIGGER_FLAG_DISABLED
작업 트리거가 비활성 상태입니다.
TriggerType
트리거 유형을 지정하는 TASK_TRIGGER_TYPE 열거형 값입니다. 이 멤버는 Type과 함께 사용됩니다. 여기에 지정된 트리거 유형에 따라 Type 멤버에 지정된 TRIGGER_TYPE_UNION 필드가 결정됩니다. 트리거 유형은 트리거가 작업을 실행하는 시기를 기반으로 합니다.
Type
트리거에 대한 세부 정보를 지정하는 TRIGGER_TYPE_UNION 구조체입니다. TriggerType 멤버는 사용할 TRIGGER_TYPE_UNION 공용 구조체의 필드를 결정합니다.
Reserved2
내부용으로만 사용; 이 값은 0이어야 합니다.
wRandomMinutesInterval
현재 사용되지 않습니다.
설명
이러한 시간에는 작업 항목의 시작 시간, 종료 시간, 기간 및 수정 플래그가 포함될 수 있습니다. 트리거를 설정할 때 시작 날짜 월과 연도를 설정해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | mstask.h |