网站首页  词典首页

请输入您要查询的函数:

 

术语 netschedulejobenum
释义 NetScheduleJobEnum
语法:
C++
NET_API_STATUS NetScheduleJobEnum(
__in_opt LPCWSTR Servername,
__out LPBYTE *PointerToBuffer,
__in DWORD PreferredMaximumLength,
__out LPDWORD EntriesRead,
__out LPDWORD TotalEntries,
__inout LPDWORD ResumeHandle
);
NetScheduleJobEnum功能
该NetScheduleJobEnum函数列出指定的计算机上排队的就业机会。此函数需要的时间服务启动。
参数
服务器名称[中,可选]
一个常量字符串,它指定的DNS或NetBIOS的远程服务器上的功能是执行名称的指针。如果该参数为NULL,则使用本地计算机。
PointerToBuffer [out]
一个缓冲区,接收数据的指针。返回的信息是AT_ENUM结构的数组。缓冲区分配制度,必须释放使用单一调用NetApiBufferFree功能。请注意,您必须释放缓冲区,即使函数ERROR_MORE_DATA失败。
PreferredMaximumLength [in]
一个值,指示返回的数据以字节为首选的最大长度。如果您指定MAX_PREFERRED_LENGTH,功能分配用于数据所需的内存量。如果指定这个参数在另一个值,它可以限制的字节数函数返回。如果缓冲区大小不足以容纳所有作品,该函数返回ERROR_MORE_DATA。有关更多信息,请参阅网络管理功能,缓冲器和网络管理功能缓冲区长度。
EntriesRead [out]
一个值,接收元素计数实际列举的指针。
TotalEntries [out]
一个值,得到了本来可以参赛作品总数的指针从当前列举的恢复状况。请注意,应用程序应考虑仅作为提示此值。
ResumeHandle [ in , out ]
一个值,包含一个恢复处理是用来枚举继续工作的指针。手柄应在第一次调用零,离开后续调用不变。如果该参数为NULL,则没有恢复处理存储。
返回值
如果函数成功,返回值是NERR_Success。
如果函数失败,返回值是一个系统错误代码。对于一个错误代码的列表,请参见系统错误代码。
备注
通常只成员本地Administrators组的计算机上工作的时间表正在枚举可以成功地执行这一职能。如果服务器名称的字符串传递指向的服务器名参数是一个远程服务器,然后本地Administrators组的成员可以在服务器上成功地执行这一职能。
如果以下注册表值最低有效位设置(例如,0x00000001),然后用户属于Server Operators组也可以成功地执行这一功能。
HKLM \\系统\\ CurrentControlSet \\控制\\唾液酸\\ SubmitControl
每个条目返回包含一个AT_ENUM结构。的的JobID成员的值时可以使用通话功能,需要就业的标识符的参数,如NetScheduleJobDel功能。
要求:
最低支持:client-Windows 2000专业版
最低支持server-Windows 2000服务器
HeaderLmat.h(包括Lmat.h)
LibraryNetapi32.lib
DLLNetapi32.dll
参见
网络管理概述
网络管理功能
附表功能
AT_ENUM
NetScheduleJobAdd
NetScheduleJobDel
NetScheduleJobGetInfo
如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com)
生成日期:2009年8月13日
==英文原文==NetScheduleJobEnum Function
The NetScheduleJobEnum function lists the jobs queued on a specified computer. This function requires that the schedule service be started.
Syntax
C++
NET_API_STATUS NetScheduleJobEnum(
__in_opt LPCWSTR Servername,
__out LPBYTE *PointerToBuffer,
__in DWORD PreferredMaximumLength,
__out LPDWORD EntriesRead,
__out LPDWORD TotalEntries,
__inout LPDWORD ResumeHandle
);
Parameters
Servername [in, optional]
A pointer to a constant string that specifies the DNS or NetBIOS name of the remote server on which the function is to execute. If this parameter is NULL, the local computer is used.
PointerToBuffer [out]
A pointer to the buffer that receives the data. The return information is an array of AT_ENUM structures. The buffer is allocated by the system and must be freed using a single call to the NetApiBufferFree function. Note that you must free the buffer even if the function fails with ERROR_MORE_DATA.
PreferredMaximumLength [in]
A value that indicates the preferred maximum length of the returned data, in bytes. If you specify MAX_PREFERRED_LENGTH, the function allocates the amount of memory required for the data. If you specify another value in this parameter, it can restrict the number of bytes that the function returns. If the buffer size is insufficient to hold all entries, the function returns ERROR_MORE_DATA. For more information, see Network Management Function Buffers and Network Management Function Buffer Lengths .
EntriesRead [out]
A pointer to a value that receives the count of elements actually enumerated.
TotalEntries [out]
A pointer to a value that receives the total number of entries that could have been enumerated from the current resume position. Note that applications should consider this value only as a hint.
ResumeHandle [in, out]
A pointer to a value that contains a resume handle which is used to continue a job enumeration. The handle should be zero on the first call and left unchanged for subsequent calls. If this parameter is NULL, then no resume handle is stored.
Return Value
If the function succeeds, the return value is NERR_Success.
If the function fails, the return value is a system error code. For a list of error codes, see System Error Codes .
Remarks
Normally only members of the local Administrators group on the computer where the schedule job is being enumerated can successfully execute this function. If the server name passed in the string pointed to by the Servername parameter is a remote server, then only members of the local Administrators group on the server can successfully execute this function.
If the following registry value has the least significant bit set (for example, 0x00000001), then users belonging to the Server Operators group can also successfully execute this function.
HKLM\\System\\CurrentControlSet\\Control\\Lsa\\SubmitControl
Each entry returned contains an AT_ENUM structure. The value of the JobId member can be used when calling functions that require a job identifier parameter, such as the NetScheduleJobDel function.
Requirements
Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderLmat.h (include Lmat.h)
LibraryNetapi32.lib
DLLNetapi32.dll
See Also
Network Management Overview
Network Management Functions
Schedule Functions
AT_ENUM
NetScheduleJobAdd
NetScheduleJobDel
NetScheduleJobGetInfo
Send comments about this topic to Microsoft
Build date: 8/13/2009
==原始网址==http://msdn.microsoft.com/en-us/library/aa370616(VS.85).aspx\n
随便看

 

windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。

 

Copyright © 2004-2023 Winrtm.com All Rights Reserved
京ICP备2021023879号-40 更新时间:2024/10/6 11:24:20