CreateJobObjectW 函数 (jobapi2.h)
创建或打开作业对象。
语法
HANDLE CreateJobObjectW(
[in, optional] LPSECURITY_ATTRIBUTES lpJobAttributes,
[in, optional] LPCWSTR lpName
);
参数
[in, optional] lpJobAttributes
指向 SECURITY_ATTRIBUTES 结构的指针,该结构指定作业对象的安全描述符,并确定子进程是否可以继承返回的句柄。 如果 lpJobAttributesNULL,则作业对象将获取默认的安全描述符,并且无法继承句柄。 作业对象的默认安全描述符中的 ACL 来自创建者的主要或模拟令牌。
[in, optional] lpName
作业的名称。 名称限制为 MAX_PATH 个字符。 名称比较区分大小写。
如果 lpNameNULL,则创建作业时不带名称。
如果 lpName 与现有事件、信号灯、互斥体、可等待计时器或文件映射对象的名称匹配,则函数将失败,GetLastError 函数返回 ERROR_INVALID_HANDLE。 之所以发生这种情况,是因为这些对象共享相同的命名空间。
可以在专用命名空间中创建对象。 有关详细信息,请参阅 对象命名空间。
终端服务:名称可以具有“Global\”或“Local\”前缀,以在全局或会话命名空间中显式创建对象。 名称的其余部分可以包含除反斜杠字符(\)以外的任何字符。 有关详细信息,请参阅 内核对象命名空间。
返回值
如果函数成功,则返回值是作业对象的句柄。 句柄具有 JOB_OBJECT_ALL_ACCESS 访问权限。 如果在函数调用之前存在该对象,该函数将返回现有作业对象的句柄,GetLastError 返回 ERROR_ALREADY_EXISTS。
如果函数失败,则返回值为 NULL。 若要获取扩展的错误信息,请调用 GetLastError。
言论
创建作业时,其会计信息初始化为零,所有限制都处于非活动状态,并且没有关联的进程。 若要将进程分配给作业对象,请使用 AssignProcessToJobObject 函数。 若要设置作业的限制,请使用 SetInformationJobObject 函数。 若要查询会计信息,请使用 QueryInformationJobObject 函数。
与作业关联的所有进程都必须在同一会话中运行。 作业与要分配给作业的第一个进程的会话相关联。
Windows Server 2003 和 Windows XP:作业与创建作业的进程会话相关联。
若要关闭作业对象句柄,请使用 CloseHandle 函数。 作业在关闭其最后一个句柄并且所有关联的进程已退出时被销毁。 但是,如果作业指定了 JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE 标志,则关闭最后一个作业对象句柄将终止所有关联的进程,然后销毁作业对象本身。
若要编译使用此函数的应用程序,请将 _WIN32_WINNT 定义为0x0500或更高版本。 有关详细信息,请参阅 使用 Windows 标头。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows XP [仅限桌面应用] |
支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | 窗户 |
标头 | jobapi2.h (包括 Windows.h、Jobapi2.h) |
库 | Kernel32.lib |
DLL | Kernel32.dll |