IsProcessInJob, fonction (jobapi.h)
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 |