OpenJobObjectW 函数 (jobapi2.h)
打开现有作业对象。
语法
HANDLE OpenJobObjectW(
[in] DWORD dwDesiredAccess,
[in] BOOL bInheritHandle,
[in] LPCWSTR lpName
);
参数
[in] dwDesiredAccess
对作业对象的访问。 此参数可以是 一个或多个作业对象的访问权限。 针对对象的任何安全描述符检查此访问权限。
[in] bInheritHandle
如果此值为 TRUE,则此进程创建的进程将继承句柄。 否则,进程不会继承此句柄。
[in] lpName
要打开的作业的名称。 名称比较区分大小写。
此函数可以打开专用命名空间中的 对象。 有关详细信息,请参阅 对象命名空间。
终端服务: 名称可以具有“Global\”或“Local\”前缀,以显式打开全局命名空间或会话命名空间中的对象。 名称的其余部分可以包含除反斜杠字符 (\) 以外的任何字符。 有关详细信息,请参阅 内核对象命名空间。
返回值
如果函数成功,则返回值是作业的句柄。 句柄提供对作业的请求访问权限。
如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
注解
若要将进程与作业相关联,请使用 AssignProcessToJobObject 函数。
若要编译使用此函数的应用程序, 请将_WIN32_WINNT 定义为 0x0500 或更高版本。 有关详细信息,请参阅 使用 Windows 标头。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | jobapi2.h (包括 Windows.h、Jobapi2.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |