Platform SDK: Network Management

AT_ENUM

The AT_ENUM structure contains information about a sumbitted job. The NetScheduleJobEnum function uses this structure to enumerate and return information about an entire queue of submitted jobs.

typedef struct _AT_ENUM {
  DWORD       JobId;
  DWORD_PTR   JobTime;
  DWORD       DaysOfMonth;
  UCHAR       DaysOfWeek;
  UCHAR       Flags;
  LPWSTR      Command;
} AT_ENUM, *PAT_ENUM, *LPAT_ENUM;

Members

JobId
Specifies a DWORD value that contains the job identifier of a submitted (queued) job.
JobTime
Specifies a value that indicates the time of day at which the job is scheduled to run. The time is the local time at a computer on which the schedule service is running; it is measured from midnight, and is expressed in milliseconds.
DaysOfMonth
Specifies a DWORD value that contains a set of bit flags representing the days of the month. For each bit that is set, the scheduled job will run at the time specified by the JobTime member, on the corresponding day of the month. Bit 0 corresponds to the first day of the month, and so on.

The value of the bitmask is zero if the job was scheduled to run only once, at the first occurrence of JobTime.

DaysOfWeek
Specifies a variable that contains a set of bit flags representing the days of the week. For each bit that is set, the scheduled job will run at the time specified by the JobTime member, on the corresponding day of the week. Bit 0 corresponds to Monday, and so on.

The value of the bitmask is zero if the job was scheduled to run only once, at the first occurrence of JobTime.

Flags
Specifies a variable that contains a set of bit flags describing job properties. This member can be 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 is equal to its original value, that is, the value when the job was submitted.

Command
Pointer to a Unicode string that contains the name of the command, batch program, or binary file to execute.

Remarks

For more information about setting the bit flags to schedule jobs that execute once, jobs that execute multiple times, and jobs that execute periodically without deletion, see NetScheduleJobAdd.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Lmat.h.

See Also

Network Management Overview, Network Management Structures, Schedule Functions, NetScheduleJobEnum