Función OpenJobObjectA (winbase.h)

Abre un objeto de trabajo existente.

Sintaxis

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

Parámetros

[in] dwDesiredAccess

Acceso al objeto de trabajo. Este parámetro puede ser uno o varios de los derechos de acceso a objetos de trabajo. Este derecho de acceso se comprueba con cualquier descriptor de seguridad para el objeto.

[in] bInheritHandle

Si este valor es TRUE, los procesos creados por este proceso heredarán el identificador. De lo contrario, los procesos no heredan este identificador.

[in] lpName

Nombre del trabajo que se va a abrir. Las comparaciones de nombres distinguen mayúsculas de minúsculas.

Esta función puede abrir objetos en un espacio de nombres privado. Para obtener más información, vea Espacios de nombres de objeto.

Terminal Services: El nombre puede tener un prefijo "Global" o "Local" para abrir explícitamente el objeto en el espacio de nombres global o de sesión. El resto del nombre puede contener cualquier carácter excepto el carácter de barra diagonal inversa (\). Para obtener más información, vea Espacios de nombres de objeto kernel.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador para el trabajo. El identificador proporciona el acceso solicitado al trabajo.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Un error de ERROR_FILE_NOT_FOUND indica que el trabajo especificado en lpName no existe.

Comentarios

Para asociar un proceso a un trabajo, use la función AssignProcessToJobObject .

Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0500 o posterior. Para obtener más información, vea Usar los encabezados de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h, Jobapi2.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

AssignProcessToJobObject

Objetos de trabajo

Funciones de proceso y subproceso