Поделиться через

структура 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 .

DaysOfWeek

Тип: UCHAR

Набор битовых флагов, представляющих дни недели. Для каждого заданного бита запланированное задание будет выполняться в указанное участником JobTime время в соответствующий день недели. Бит 0 соответствует понедельнику и т. д.

Значение битовой маски равно нулю, если задание было запланировано для выполнения только один раз, при первом вхождлении, указанном элементом JobTime .

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

Общие сведения об управлении сетью

Структуры управления сетью

Функции расписания