netScheduleJobGetInfo 函数 (lmat.h)
[自 Windows 8 起,NetScheduleJobGetInfo 不再可供使用。 请改用 任务计划程序 2.0 接口。
]
NetScheduleJobGetInfo 函数检索有关在指定计算机上排队的特定作业的信息。 此函数要求启动计划服务。
语法
NET_API_STATUS NET_API_FUNCTION NetScheduleJobGetInfo(
[in, optional] LPCWSTR Servername,
[in] DWORD JobId,
[out] LPBYTE *PointerToBuffer
);
parameters
[in, optional] Servername
指向常量字符串的指针,该常量字符串指定要在其中执行函数的远程服务器的 DNS 或 NetBIOS 名称。 如果此参数为 NULL,则使用本地计算机。
[in] JobId
一个 值,该值指示要为其检索信息的作业的标识符。
[out] PointerToBuffer
指向缓冲区的指针,该缓冲区接收描述指定作业 的 AT_INFO 结构。 此缓冲区由系统分配,必须使用 NetApiBufferFree 函数释放。 有关详细信息,请参阅 网络管理功能缓冲区 和 网络管理功能缓冲区长度。
返回值
如果函数成功,则返回值NERR_Success。
如果函数失败,则返回值为系统错误代码。 有关错误代码的列表,请参阅 系统错误代码。
注解
通常,只有枚举计划作业的计算机上的本地 Administrators 组的成员才能成功执行此函数。 如果 Servername 参数指向的字符串中传递的服务器名称是远程服务器,则只有服务器上的本地 Administrators 组的成员才能成功执行此函数。
如果以下注册表值具有 ((例如,0x00000001) )设置的最小有效位,则属于服务器操作员组的用户也可以成功执行此函数。
HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | lmat.h (包括 Lmat.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |