JOBOBJECT_END_OF_JOB_TIME_INFORMATION structure (winnt.h)
Specifies the action the system will perform when an end-of-job time limit is exceeded.
Syntax
typedef struct _JOBOBJECT_END_OF_JOB_TIME_INFORMATION {
DWORD EndOfJobTimeAction;
} JOBOBJECT_END_OF_JOB_TIME_INFORMATION, *PJOBOBJECT_END_OF_JOB_TIME_INFORMATION;
Members
EndOfJobTimeAction
The action that the system will perform when the end-of-job time limit has been exceeded. This member can be one of the following values.
| Value | Meaning |
|---|---|
|
Terminates all processes and sets the exit status to ERROR_NOT_ENOUGH_QUOTA. The processes cannot prevent or delay their own termination. The job object is set to the signaled state and remains signaled until this limit is reset. No additional processes can be assigned to the job until the limit is reset.
This is the default termination action. |
|
Posts a completion packet to the completion port using the
PostQueuedCompletionStatus function. After the completion packet is posted, the system clears the end-of-job time limit, and processes in the job can continue their execution.
If no completion port is associated with the job when the time limit has been exceeded, the action taken is the same as for JOB_OBJECT_TERMINATE_AT_END_OF_JOB. |
Remarks
The end-of-job time limit is specified in the PerJobUserTimeLimit member of the JOBOBJECT_BASIC_LIMIT_INFORMATION structure.
To associate a completion port with a job, use the JOBOBJECT_ASSOCIATE_COMPLETION_PORT structure.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Header | winnt.h (include Windows.h) |
See also
JOBOBJECT_ASSOCIATE_COMPLETION_PORT