AT_INFO 구조체(lmat.h)

  • 아티클

AT_INFO 구조에는 작업에 대한 정보가 포함됩니다. NetScheduleJobAdd 함수는 구조를 사용하여 작업을 예약할 때 정보를 지정합니다. NetScheduleJobGetInfo 함수는 구조를 사용하여 이미 제출된 작업에 대한 정보를 검색합니다.

구문

typedef struct _AT_INFO {
  DWORD_PTR JobTime;
  DWORD     DaysOfMonth;
  UCHAR     DaysOfWeek;
  UCHAR     Flags;
  LPWSTR    Command;
} AT_INFO, *PAT_INFO, *LPAT_INFO;

멤버

JobTime

형식: DWORD_PTR

작업이 실행되도록 예약된 시간을 나타내는 값에 대한 포인터입니다. 시간은 일정 서비스가 실행 중인 컴퓨터의 현지 시간입니다. 자정부터 측정되며 밀리초 단위로 표현됩니다.

DaysOfMonth

형식:DWORD

월의 일을 나타내는 비트 플래그 집합입니다. 설정된 각 비트에 대해 예약된 작업은 해당 월의 날짜에 JobTime 멤버가 지정한 시간에 실행됩니다. 비트 0은 월의 첫째 날에 해당합니다.

작업이 JobTime 멤버에 의해 지정된 첫 번째 발생 시 한 번만 실행되도록 예약된 경우 비트 마스크의 값은 0입니다.

DaysOfWeek

형식: UCHAR

요일을 나타내는 비트 플래그 집합입니다. 설정된 각 비트에 대해 예약된 작업은 JobTime 멤버가 지정한 시간에 해당 요일에 실행됩니다. 비트 0은 월요일 등에 해당합니다.

작업이 JobTime 멤버에 의해 지정된 첫 번째 발생 시 한 번만 실행되도록 예약된 경우 비트 마스크의 값은 0입니다.

Flags

형식: UCHAR

작업 속성을 설명하는 비트 플래그 집합입니다.

NetScheduleJobAdd 함수에 대한 호출을 사용하여 작업을 제출할 때 다음 값 중 하나를 지정할 수 있습니다.

값 의미
JOB_RUN_PERIODICALLY
 이 플래그를 설정하면 DaysOfMonth 멤버 또는 DaysOfWeek 멤버에서 해당 비트가 설정된 날마다 작업이 실행되고 계속 실행됩니다. 작업이 실행된 후에는 삭제되지 않습니다.

이 플래그가 명확한 경우 작업은 이러한 멤버에 설정된 각 비트에 대해 한 번만 실행됩니다. 작업이 한 번 실행되면 삭제됩니다.
JOB_ADD_CURRENT_DATE
 이 플래그를 설정하면 작업이 큐에 대기 중인 컴퓨터에서 JobTime 멤버가 처음 발생할 때 작업이 실행됩니다.

이 플래그를 설정하는 것은 DaysOfMonth 멤버에서 현재 날짜에 대한 비트를 설정하는 것과 같습니다.
JOB_NONINTERACTIVE
 이 플래그를 설정하면 작업이 대화형으로 실행되지 않습니다.

이 플래그가 명확하면 작업이 대화형으로 실행됩니다.
 

NetScheduleJobGetInfo를 호출하여 작업 정보를 검색하는 경우 함수는 다음 값 중 하나 이상을 반환할 수 있습니다.

값 의미
JOB_RUN_PERIODICALLY
 이 플래그는 원래 값, 즉 작업이 제출되었을 때의 값과 같습니다.
JOB_EXEC_ERROR
 이 플래그가 설정된 경우 일정 서비스가 마지막으로 실행되도록 예약된 작업을 성공적으로 실행하지 못했음을 나타냅니다.
JOB_RUNS_TODAY
 이 플래그가 설정되면 작업이 현재 날짜에 실행되도록 예약되었음을 나타냅니다. JobTime 멤버의 값이 작업이 큐에 대기 중인 컴퓨터의 현재 시간보다 큽니다.
JOB_NONINTERACTIVE
 이 플래그 비트는 원래 값, 즉 작업이 제출되었을 때의 값과 같습니다.

Command

형식: LPWSTR

실행할 명령, 일괄 처리 프로그램 또는 이진 파일의 이름을 포함하는 유니코드 문자열에 대한 포인터입니다.

설명

한 번 실행되는 작업 예약, 여러 번 실행되는 작업 및 삭제 없이 주기적으로 실행되는 작업에 대한 자세한 내용은 NetScheduleJobAdd를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 lmat.h(Lm.h 포함)

추가 정보

NetScheduleJobAdd

NetScheduleJobGetInfo

네트워크 관리 개요

네트워크 관리 구조

일정 함수