AT_INFO Struktur (lmat.h)

Artikel
08/24/2023

Die AT_INFO-Struktur enthält Informationen zu einem Auftrag. Die NetScheduleJobAdd-Funktion verwendet die Struktur, um Informationen beim Planen eines Auftrags anzugeben. Die NetScheduleJobGetInfo-Funktion verwendet die Struktur, um Informationen zu einem bereits übermittelten Auftrag abzurufen.

Syntax

typedef struct _AT_INFO {
  DWORD_PTR JobTime;
  DWORD     DaysOfMonth;
  UCHAR     DaysOfWeek;
  UCHAR     Flags;
  LPWSTR    Command;
} AT_INFO, *PAT_INFO, *LPAT_INFO;

Member

JobTime

Typ: DWORD_PTR

Ein Zeiger auf einen Wert, der die Tageszeit angibt, zu der der Auftrag ausgeführt werden soll. Die Uhrzeit ist die Lokale Zeit auf einem Computer, auf dem der Zeitplandienst ausgeführt wird. sie wird ab Mitternacht gemessen und in Millisekunden ausgedrückt.

DaysOfMonth

Art: DWORD

Eine Reihe von Bitflags, die die Tage des Monats darstellen. Für jedes festgelegte Bit wird der geplante Auftrag zu dem vom JobTime-Member angegebenen Zeitpunkt am entsprechenden Tag des Monats ausgeführt. Bit 0 entspricht dem ersten Tag des Monats usw.

Der Wert der Bitmaske ist 0, wenn die Ausführung des Auftrags nur einmal geplant wurde, bei dem ersten vom JobTime-Member angegebenen Vorkommen.

DaysOfWeek

Typ: UCHAR

Eine Reihe von Bitflags, die die Wochentage darstellen. Für jedes festgelegte Bit wird der geplante Auftrag zu dem vom JobTime-Member angegebenen Zeitpunkt am entsprechenden Wochentag ausgeführt. Bit 0 entspricht Montag usw.

Der Wert der Bitmaske ist 0, wenn die Ausführung des Auftrags nur einmal geplant wurde, bei dem ersten vom JobTime-Member angegebenen Vorkommen.

Flags

Typ: UCHAR

Eine Reihe von Bitflags, die Auftragseigenschaften beschreiben.

Wenn Sie einen Auftrag mit einem Aufruf der NetScheduleJobAdd-Funktion übermitteln, können Sie einen der folgenden Werte angeben.

Wert	Bedeutung
JOB_RUN_PERIODICALLY	Wenn Sie dieses Flag festlegen, wird der Auftrag an jedem Tag ausgeführt, für den ein entsprechendes Bit im DaysOfMonth-Element oder im DaysOfWeek-Member festgelegt ist. Der Auftrag wird nach der Ausführung nicht gelöscht. Wenn dieses Flag eindeutig ist, wird der Auftrag nur einmal für jedes Bit ausgeführt, das in diesen Membern festgelegt ist. Der Auftrag wird gelöscht, nachdem er einmal ausgeführt wurde.
JOB_ADD_CURRENT_DATE	Wenn Sie dieses Flag festlegen, wird der Auftrag beim ersten Vorkommen des JobTime-Members auf dem Computer ausgeführt, auf dem sich der Auftrag in der Warteschlange befindet. Das Festlegen dieses Flags entspricht dem Festlegen des Bits für den aktuellen Tag im DaysOfMonth-Element .
JOB_NONINTERACTIVE	Wenn Sie dieses Flag festlegen, wird der Auftrag nicht interaktiv ausgeführt. Wenn dieses Flag eindeutig ist, wird der Auftrag interaktiv ausgeführt.

Wenn Sie NetScheduleJobGetInfo aufrufen, um Auftragsinformationen abzurufen, kann die Funktion einen oder mehrere der folgenden Werte zurückgeben.

Wert	Bedeutung
JOB_RUN_PERIODICALLY	Dieses Flag entspricht dem ursprünglichen Wert, d. h. dem Wert beim Übermitteln des Auftrags.
JOB_EXEC_ERROR	Wenn dieses Flag festgelegt ist, gibt dies an, dass der Zeitplandienst den Auftrag bei der letzten geplanten Ausführung nicht erfolgreich ausführen konnte.
JOB_RUNS_TODAY	Wenn dieses Flag festgelegt ist, gibt dies an, dass die Ausführung des Auftrags am aktuellen Tag geplant ist. der Wert des JobTime-Members ist größer als die aktuelle Tageszeit auf dem Computer, auf dem sich der Auftrag in der Warteschlange befindet.
JOB_NONINTERACTIVE	Dieses Flagbit entspricht dem ursprünglichen Wert, d. h. dem Wert bei der Übermittlung des Auftrags.

Command

Typ: LPWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen des auszuführenden Befehls, des Batchprogramms oder der Binärdatei enthält.

Hinweise

Weitere Informationen zum Planen von Aufträgen, die einmal ausgeführt werden, Aufträgen, die mehrmals ausgeführt werden, und Aufträgen, die regelmäßig ohne Löschung ausgeführt werden, finden Sie unter NetScheduleJobAdd.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	lmat.h (include Lm.h)

Weitere Informationen

NetScheduleJobAdd

NetScheduleJobGetInfo

Übersicht über die Netzwerkverwaltung

Netzwerkverwaltungsstrukturen

Funktionen planen

Freigeben über