AT_ENUM-Struktur (lmat.h)

Artikel
08/24/2023

Die AT_ENUM-Struktur enthält Informationen zu einem übermittelten Auftrag. Die NetScheduleJobEnum-Funktion verwendet diese Struktur, um Informationen zu einer gesamten Warteschlange mit übermittelten Aufträgen aufzulisten und zurückzugeben.

Syntax

typedef struct _AT_ENUM {
  DWORD     JobId;
  DWORD_PTR JobTime;
  DWORD     DaysOfMonth;
  UCHAR     DaysOfWeek;
  UCHAR     Flags;
  LPWSTR    Command;
} AT_ENUM, *PAT_ENUM, *LPAT_ENUM;

Members

JobId

Art: DWORD

Der Auftragsbezeichner eines übermittelten (in die Warteschlange eingereihten) Auftrags.

JobTime

Typ: DWORD_PTR

Ein Zeiger auf die Tageszeit, zu der die Ausführung des Auftrags geplant ist. 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

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

Der Wert der Bitmaske ist null, wenn die Ausführung des Auftrags nur einmal geplant wurde, bei dem ersten Vorkommen, das im JobTime-Element angegeben ist.

DaysOfWeek

Typ: UCHAR

Ein Satz 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 (null), wenn die Ausführung des Auftrags nur einmal geplant wurde, und zwar beim ersten Vorkommen, das im JobTime-Element angegeben ist.

Flags

Typ: UCHAR

Eine Reihe von Bitflags, die Auftragseigenschaften beschreiben. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
JOB_RUN_PERIODICALLY	Dieses Flag ist gleich seinem ursprünglichen Wert, d. h. dem Wert, der beim Übermitteln des Auftrags erfolgt ist.
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-Elements ist größer als die aktuelle Tageszeit auf dem Computer, auf dem sich der Auftrag in der Warteschlange befindet.
JOB_NONINTERACTIVE	Dieses Flag ist gleich seinem ursprünglichen Wert, d. h. dem Wert, der beim Übermitteln des Auftrags erfolgt ist.

Command

Typ: LPWSTR

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

Hinweise

Weitere Informationen zum Festlegen der Bitflags 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 in der NetScheduleJobAdd-Funktion .

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	lmat.h (lm.h einschließen)

Weitere Informationen

NetScheduleJobEnum

Übersicht über die Netzwerkverwaltung

Netzwerkverwaltungsstrukturen

Planen von Funktionen

Freigeben über