structure JOBOBJECT_END_OF_JOB_TIME_INFORMATION (winnt.h)

Article
08/27/2023

Spécifie l’action que le système effectuera lorsqu’une limite de temps de fin de travail est dépassée.

Syntaxe

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

Membres

EndOfJobTimeAction

Action que le système effectuera lorsque la limite de temps de fin de travail a été dépassée. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
JOB_OBJECT_TERMINATE_AT_END_OF_JOB 0	Arrête tous les processus et définit le status de sortie sur ERROR_NOT_ENOUGH_QUOTA. Les processus ne peuvent pas empêcher ou retarder leur propre arrêt. L’objet de travail est défini sur l’état signalé et reste signalé jusqu’à ce que cette limite soit réinitialisée. Aucun processus supplémentaire ne peut être affecté au travail tant que la limite n’est pas réinitialisée. Il s’agit de l’action d’arrêt par défaut.
JOB_OBJECT_POST_AT_END_OF_JOB 1	Publie un paquet d’achèvement sur le port d’achèvement à l’aide de la fonction PostQueuedCompletionStatus . Une fois le paquet d’achèvement publié, le système efface la limite de temps de fin de travail et les processus du travail peuvent poursuivre leur exécution. Si aucun port d’achèvement n’est associé au travail lorsque la limite de temps a été dépassée, l’action effectuée est la même que pour JOB_OBJECT_TERMINATE_AT_END_OF_JOB.

Valeur

Signification

JOB_OBJECT_TERMINATE_AT_END_OF_JOB
0

Arrête tous les processus et définit le status de sortie sur ERROR_NOT_ENOUGH_QUOTA. Les processus ne peuvent pas empêcher ou retarder leur propre arrêt. L’objet de travail est défini sur l’état signalé et reste signalé jusqu’à ce que cette limite soit réinitialisée. Aucun processus supplémentaire ne peut être affecté au travail tant que la limite n’est pas réinitialisée.

Il s’agit de l’action d’arrêt par défaut.

JOB_OBJECT_POST_AT_END_OF_JOB
1

Publie un paquet d’achèvement sur le port d’achèvement à l’aide de la fonction PostQueuedCompletionStatus . Une fois le paquet d’achèvement publié, le système efface la limite de temps de fin de travail et les processus du travail peuvent poursuivre leur exécution.

Si aucun port d’achèvement n’est associé au travail lorsque la limite de temps a été dépassée, l’action effectuée est la même que pour JOB_OBJECT_TERMINATE_AT_END_OF_JOB.

Remarques

La limite de temps de fin de travail est spécifiée dans le membre PerJobUserTimeLimit de la structure JOBOBJECT_BASIC_LIMIT_INFORMATION .

Pour associer un port d’achèvement à un travail, utilisez la structure JOBOBJECT_ASSOCIATE_COMPLETION_PORT .

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	winnt.h (inclure Windows.h)

Voir aussi

JOBOBJECT_ASSOCIATE_COMPLETION_PORT

JOBOBJECT_BASIC_LIMIT_INFORMATION

PostQueuedCompletionStatus

QueryInformationJobObject

SetInformationJobObject

Partager via