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 |