lmat.h) (AT_INFO 结构

  • 项目

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

指向 Unicode 字符串的指针，该字符串包含要执行的命令、批处理程序或二进制文件的名称。

注解

有关计划执行一次的作业、多次执行的作业以及定期执行而不删除的作业的详细信息，请参阅 NetScheduleJobAdd。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 lmat.h (包括 Lm.h)

另请参阅

NetScheduleJobAdd

NetScheduleJobGetInfo

网络管理概述

网络管理结构

计划函数