TASK_TRIGGER 구조체(mstask.h)

아티클
03/15/2023

예약된 작업 항목을 실행하는 시간을 정의합니다.

구문

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