检索指向枚举器对象的接口指针,该对象用于枚举传输队列中的 作业 。 枚举器中作业的顺序是任意的。
语法
HRESULT EnumJobs(
[in] DWORD dwFlags,
[out] IEnumBackgroundCopyJobs **ppEnum
);
参数
[in] dwFlags
指定要在枚举中包含其作业。 如果 dwFlags 设置为 0,则用户将收到他们在传输队列中拥有的所有作业。 下表列出了枚举选项。
| 选项 | 含义 |
|---|---|
|
包括传输队列中的所有作业- 用户拥有的作业和其他人拥有的作业。 用户必须是管理员才能使用此标志。 |
[out] ppEnum
用于枚举传输队列中的作业的 IEnumBackgroundCopyJobs 接口指针。 枚举器的内容取决于 dwFlags 的值。 完成后释放 ppEnumJobs 。
返回值
此方法返回以下 HRESULT 值以及其他值。
| 返回代码 | 说明 |
|---|---|
|
已成功生成枚举器对象。 |
|
用户必须是管理员或属于管理员组才能枚举其他用户拥有的作业。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP |
| 最低受支持的服务器 | Windows Server 2003 |
| 目标平台 | Windows |
| 标头 | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |