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

ジョブの実行がスケジュールされている時刻を示す値へのポインター。 時刻は、スケジュール サービスが実行されているコンピューターの現地時刻です。これは午前 0 時から測定され、ミリ秒単位で表されます。

DaysOfMonth

型: DWORD

月の日を表すビット フラグのセット。 設定されたビットごとに、スケジュールされたジョブは 、JobTime メンバーによって指定された時刻 (月の対応する日) に実行されます。 ビット 0 は、月の最初の日に対応します。などです。

JobTime メンバーによって指定された最初の出現位置で、ジョブが 1 回だけ実行されるようにスケジュールされている場合、ビットマスクの値は 0 です。

DaysOfWeek

種類: UCHAR

曜日を表すビット フラグのセット。 設定されたビットごとに、スケジュールされたジョブは 、JobTime メンバーによって指定された時刻 (対応する曜日) に実行されます。 ビット 0 は月曜日に対応します。などです。

JobTime メンバーによって指定された最初の出現位置で、ジョブが 1 回だけ実行されるようにスケジュールされている場合、ビットマスクの値は 0 です。

Flags

種類: UCHAR

ジョブのプロパティを記述するビット フラグのセット。

NetScheduleJobAdd 関数の呼び出しを使用してジョブを送信する場合は、次のいずれかの値を指定できます。

値 意味
JOB_RUN_PERIODICALLY
 このフラグを設定すると、 DaysOfMonth メンバーまたは DaysOfWeek メンバーに対応するビットが設定されている各日にジョブが実行され、実行が続行されます。 ジョブは、実行後に削除されません。

このフラグが明確な場合、ジョブはこれらのメンバーに設定されたビットごとに 1 回だけ実行されます。 ジョブは、1 回実行した後に削除されます。
JOB_ADD_CURRENT_DATE
 このフラグを設定すると、ジョブは、ジョブがキューに入っているコンピューターで JobTime メンバーが最初に出現した時点で実行されます。

このフラグを設定することは、 DaysOfMonth メンバーの現在の日のビットを設定することと同じです。
JOB_NONINTERACTIVE
 このフラグを設定すると、ジョブは対話形式で実行されません。

このフラグが明確な場合、ジョブは対話形式で実行されます。
 

NetScheduleJobGetInfo を呼び出してジョブ情報を取得すると、関数は次の 1 つ以上の値を返すことができます。

値 意味
JOB_RUN_PERIODICALLY
 このフラグは、元の値、つまりジョブの送信時の値と等しくなります。
JOB_EXEC_ERROR
 このフラグが設定されている場合は、スケジュール サービスが前回実行するようにスケジュールされた時点でジョブを正常に実行できなかったことを示します。
JOB_RUNS_TODAY
 このフラグが設定されている場合は、ジョブが現在の日に実行されるようにスケジュールされていることを示します。 JobTime メンバーの値が、ジョブがキューに登録されているコンピューターの現在の時刻より大きい。
JOB_NONINTERACTIVE
 このフラグ ビットは、元の値、つまりジョブが送信されたときの値と等しくなります。

Command

種類: LPWSTR

実行するコマンド、バッチ プログラム、またはバイナリ ファイルの名前を含む Unicode 文字列へのポインター。

注釈

1 回実行するジョブのスケジュール設定、複数回実行されるジョブ、および削除せずに定期的に実行されるジョブの詳細については、「 NetScheduleJobAdd」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header lmat.h (Lm.h を含む)

こちらもご覧ください

NetScheduleJobAdd

NetScheduleJobGetInfo

ネットワーク管理の概要

ネットワーク管理構造

スケジュール関数