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

Unicode 字串的指標，其中包含要執行的命令、批次程式或二進位檔的名稱。

備註

如需排程執行一次作業、多次執行的作業，以及不刪除時定期執行的作業的詳細資訊，請參閱 NetScheduleJobAdd。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 lmat.h (包含 Lm.h)

另請參閱

NetScheduleJobAdd

NetScheduleJobGetInfo

網路管理概觀

網路管理結構

排程函式