OpenJobObjectA 函数 (winbase.h)

打开现有作业对象。

语法

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

参数

[in] dwDesiredAccess

对作业对象的访问。 此参数可以是 一个或多个作业对象访问权限。 针对对象的任何安全描述符检查此访问权限。

[in] bInheritHandle

如果此值为 TRUE,则此进程创建的进程将继承句柄。 否则,进程不会继承此句柄。

[in] lpName

要打开的作业的名称。 名称比较区分大小写。

此函数可以在专用命名空间中打开对象。 有关详细信息,请参阅 对象命名空间

终端服务: 名称可以具有“Global”或“Local”前缀,以显式打开全局命名空间或会话命名空间中的对象。 名称的其余部分可以包含除反斜杠字符 (\) 以外的任何字符。 有关详细信息,请参阅 内核对象命名空间

返回值

如果函数成功,则返回值是作业的句柄。 句柄提供对作业的请求访问权限。

如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。

ERROR_FILE_NOT_FOUND 错误指示 lpName 中指定的作业不存在。

注解

若要将进程与作业相关联,请使用 AssignProcessToJobObject 函数。

若要编译使用此函数的应用程序, 请将_WIN32_WINNT 定义为 0x0500 或更高版本。 有关详细信息,请参阅 使用 Windows 标头

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h、Jobapi2.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

AssignProcessToJobObject

作业对象

进程和线程函数