JOBOBJECT_END_OF_JOB_TIME_INFORMATION structure

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.

ValueMeaning
JOB_OBJECT_TERMINATE_AT_END_OF_JOB
0

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.

JOB_OBJECT_POST_AT_END_OF_JOB
1

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

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
JOBOBJECT_BASIC_LIMIT_INFORMATION
PostQueuedCompletionStatus
QueryInformationJobObject
SetInformationJobObject

 

 

Community Additions

ADD
Show:
© 2014 Microsoft