JOBOBJECT_END_OF_JOB_TIME_INFORMATION-Struktur (winnt.h)

Artikel
08/27/2023

Gibt die Aktion an, die das System ausführen wird, wenn ein Zeitlimit für das Auftragsende überschritten wird.

Syntax

typedef struct _JOBOBJECT_END_OF_JOB_TIME_INFORMATION {
  DWORD EndOfJobTimeAction;
} JOBOBJECT_END_OF_JOB_TIME_INFORMATION, *PJOBOBJECT_END_OF_JOB_TIME_INFORMATION;

Member

EndOfJobTimeAction

Die Aktion, die das System ausführt, wenn das Zeitlimit für das Auftragsende überschritten wurde. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
JOB_OBJECT_TERMINATE_AT_END_OF_JOB 0	Beendet alle Prozesse und legt den Exit-status auf ERROR_NOT_ENOUGH_QUOTA fest. Die Prozesse können ihre eigene Kündigung nicht verhindern oder verzögern. Das Auftragsobjekt wird auf den signalierten Zustand festgelegt und bleibt so lange signalisiert, bis dieses Limit zurückgesetzt wird. Dem Auftrag können keine zusätzlichen Prozesse zugewiesen werden, bis das Limit zurückgesetzt wird. Dies ist die Standardabbruchaktion.
JOB_OBJECT_POST_AT_END_OF_JOB 1	Sendet mithilfe der PostQueuedCompletionStatus-Funktion ein Vervollständigungspaket an den Vervollständigungsport. Nachdem das Vervollständigungspaket veröffentlicht wurde, löscht das System das Zeitlimit für das Auftragsende, und die Prozesse im Auftrag können ihre Ausführung fortsetzen. Wenn dem Auftrag kein Vervollständigungsport zugeordnet ist, wenn das Zeitlimit überschritten wurde, ist die ausgeführte Aktion mit der für JOB_OBJECT_TERMINATE_AT_END_OF_JOB identisch.

Wert

Bedeutung

JOB_OBJECT_TERMINATE_AT_END_OF_JOB
0

Beendet alle Prozesse und legt den Exit-status auf ERROR_NOT_ENOUGH_QUOTA fest. Die Prozesse können ihre eigene Kündigung nicht verhindern oder verzögern. Das Auftragsobjekt wird auf den signalierten Zustand festgelegt und bleibt so lange signalisiert, bis dieses Limit zurückgesetzt wird. Dem Auftrag können keine zusätzlichen Prozesse zugewiesen werden, bis das Limit zurückgesetzt wird.

Dies ist die Standardabbruchaktion.

JOB_OBJECT_POST_AT_END_OF_JOB
1

Sendet mithilfe der PostQueuedCompletionStatus-Funktion ein Vervollständigungspaket an den Vervollständigungsport. Nachdem das Vervollständigungspaket veröffentlicht wurde, löscht das System das Zeitlimit für das Auftragsende, und die Prozesse im Auftrag können ihre Ausführung fortsetzen.

Wenn dem Auftrag kein Vervollständigungsport zugeordnet ist, wenn das Zeitlimit überschritten wurde, ist die ausgeführte Aktion mit der für JOB_OBJECT_TERMINATE_AT_END_OF_JOB identisch.

Hinweise

Das Zeitlimit für Auftragsende wird im PerJobUserTimeLimit-Member der JOBOBJECT_BASIC_LIMIT_INFORMATION-Struktur angegeben.

Um einem Auftrag einen Vervollständigungsport zuzuordnen, verwenden Sie die JOBOBJECT_ASSOCIATE_COMPLETION_PORT-Struktur .

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winnt.h (Einschließen von Windows.h)

Weitere Informationen

JOBOBJECT_ASSOCIATE_COMPLETION_PORT

JOBOBJECT_BASIC_LIMIT_INFORMATION

PostQueuedCompletionStatus

QueryInformationJobObject

SetInformationJobObject