IsProcessInJob, fonction (jobapi.h)

  • Article

Détermine si le processus est en cours d’exécution dans le travail spécifié.

Syntaxe

BOOL IsProcessInJob(
  [in]           HANDLE ProcessHandle,
  [in, optional] HANDLE JobHandle,
  [out]          PBOOL  Result
);

Paramètres

[in] ProcessHandle

Handle du processus à tester. Le handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION. Pour plus d’informations, consultez Droits d’accès et de sécurité des processus.

Windows Server 2003 et Windows XP : Le handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION.

[in, optional] JobHandle

Handle du travail. Si ce paramètre a la valeur NULL, la fonction teste si le processus s’exécute sous n’importe quel travail.

Si ce paramètre n’est pas NULL, le handle doit avoir le droit d’accès JOB_OBJECT_QUERY. Pour plus d’informations, consultez Sécurité des objets de travail et droits d’accès.

[out] Result

Pointeur vers une valeur qui reçoit TRUE si le processus est en cours d’exécution dans le travail, et FALSE dans le cas contraire.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Une application ne peut pas obtenir de handle pour l’objet de travail dans lequel elle s’exécute, sauf si elle a le nom de l’objet de travail. Toutefois, une application peut appeler la fonction QueryInformationJobObject avec NULL pour obtenir des informations sur l’objet de travail.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0501 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête jobapi.h
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

AssignProcessToJobObject

Objets de travail

Fonctions de processus et de thread

QueryInformationJobObject