OpenJobObjectA, fonction (winbase.h)

Ouvre un objet de travail existant.

Syntaxe

HANDLE OpenJobObjectA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR lpName
);

Paramètres

[in] dwDesiredAccess

Accès à l’objet de travail. Ce paramètre peut être un ou plusieurs des droits d’accès à l’objet de travail. Ce droit d’accès est vérifié par rapport à n’importe quel descripteur de sécurité pour l’objet .

[in] bInheritHandle

Si cette valeur est TRUE, les processus créés par ce processus héritent du handle. Sinon, les processus n’héritent pas de ce handle.

[in] lpName

Nom du travail à ouvrir. Les comparaisons de noms respectent la casse.

Cette fonction peut ouvrir des objets dans un espace de noms privé. Pour plus d’informations, consultez Espaces de noms d’objets.

Terminal Services : Le nom peut avoir un préfixe « Global » ou « Local » pour ouvrir explicitement l’objet dans l’espace de noms global ou de session. Le reste du nom peut contenir n’importe quel caractère à l’exception de la barre oblique inverse (\). Pour plus d’informations, consultez Espaces de noms d’objets du noyau.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour le travail. Le handle fournit l’accès demandé au travail.

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

Une erreur de ERROR_FILE_NOT_FOUND indique que le travail spécifié dans lpName n’existe pas.

Remarques

Pour associer un processus à un travail, utilisez la fonction AssignProcessToJobObject .

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0500 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	winbase.h (inclure Windows.h, Jobapi2.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

AssignProcessToJobObject

Objets de travail

Fonctions de processus et de thread