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 |