Platform SDK: Network Management |
The AT_INFO structure contains information about a job. The NetScheduleJobAdd function uses the structure to specify information when scheduling a job. The NetScheduleJobGetInfo function uses the structure to retrieve information about a job that has already been submitted.
typedef struct _AT_INFO { DWORD_PTR JobTime; DWORD DaysOfMonth; UCHAR DaysOfWeek; UCHAR Flags; LPWSTR Command; } AT_INFO, *PAT_INFO, *LPAT_INFO;
The value of the bitmask is zero if the job was scheduled to run only once, at the first occurrence of JobTime.
The value of the bitmask is zero if the job was scheduled to run only once, at the first occurrence of JobTime.
Submitting jobs. When you submit a job using a call to the NetScheduleJobAdd function, you can specify one of the following values.
Value | Meaning |
---|---|
JOB_RUN_PERIODICALLY | If you set this flag, the job runs, and continues to run, on each day for which a corresponding bit is set in the DaysOfMonth or DaysOfWeek member. The job is not deleted after it executes.
If this flag is clear, the job runs only once for each bit set in these members. The job is deleted after it executes once. |
JOB_ADD_CURRENT_DATE | If you set this flag, the job executes at the first occurrence of JobTime at the computer where the job is queued.
Setting this flag is equivalent to setting the bit for the current day in the DaysOfMonth member. |
JOB_NONINTERACTIVE | If you set this flag, the job does not run interactively.
If this flag is clear, the job runs interactively. |
Retrieving job information. When you call NetScheduleJobGetInfo to retrieve job information, the function can return one or more of the following values.
Value | Meaning |
---|---|
JOB_RUN_PERIODICALLY | This flag is equal to its original value, that is, the value when the job was submitted. |
JOB_EXEC_ERROR | If this flag is set, it indicates that the schedule service failed to successfully execute the job the last time it was scheduled to run. |
JOB_RUNS_TODAY | If this flag is set, it indicates that the job is scheduled to execute on the current day; the value of the JobTime member is greater than the current time of day at the computer where the job is queued. |
JOB_NONINTERACTIVE | This flag bit is equal to its original value, that is, the value when the job was submitted. |
For more information about scheduling jobs that execute once, jobs that execute multiple times, and jobs that execute periodically without deletion, see NetScheduleJobAdd.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Unsupported.
Header: Declared in Lmat.h.
Network Management Overview, Network Management Structures, Schedule Functions, NetScheduleJobAdd, NetScheduleJobGetInfo