NetScheduleJobDel 函数 (lmat.h)

项目
08/24/2023

[自 Windows 8 起，NetScheduleJobDel 不再可供使用。请改用任务计划程序 2.0 接口。

]

NetScheduleJobDel 函数删除排队在计算机中运行的一系列作业。此函数要求在作业删除请求发送到的计算机处启动计划服务。

语法

NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   MinJobId,
  [in]           DWORD   MaxJobId
);

parameters

[in, optional] Servername

指向常量字符串的指针，该字符串指定要对其执行函数的远程服务器的 DNS 或 NetBIOS 名称。如果此参数为 NULL，则使用本地计算机。

[in] MinJobId

最小作业标识符。不会删除作业标识符小于 MinJobId 的作业。

[in] MaxJobId

最大作业标识符。作业标识符大于 MaxJobId 的作业不会被删除。

返回值

如果函数成功，则返回值NERR_Success。

如果函数失败，则返回值为系统错误代码。有关错误代码的列表，请参阅系统错误代码。

注解

通常，只有正在删除计划作业的计算机上的本地管理员组的成员才能成功执行此功能。如果 服务器名称 参数指向的字符串中传递的服务器名称是远程服务器，则只有服务器上的本地管理员组的成员才能成功执行此函数。

如果以下注册表值具有 (最小有效位集，例如，0x00000001) ，则属于服务器操作员组的用户也可以成功执行此函数。

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

调用 NetScheduleJobEnum 函数以检索一个或多个计划作业的作业标识符。

NetScheduleJobDel 函数删除作业标识符在 MinJobId 到 MaxJobId 范围内的所有作业。

若要删除服务器上的所有计划作业，可以调用 NetScheduleJobDel ，指定 MinJobId 等于 0， MaxJobId 等于 – 1。若要删除一个作业，请同时指定 MinJobId 参数和 MaxJobId 参数的作业标识符。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	lmat.h (包括 Lmat.h)
Library	Netapi32.lib
DLL	Netapi32.dll