IBackgroundCopyManager::EnumJobs 方法 (bits.h)

检索指向枚举器对象的接口指针,该对象用于枚举传输队列中的 作业 。 枚举器中作业的顺序是任意的。

语法

HRESULT EnumJobs(
  [in]  DWORD                   dwFlags,
  [out] IEnumBackgroundCopyJobs **ppEnum
);

参数

[in] dwFlags

指定要在枚举中包含其作业。 如果 dwFlags 设置为 0,则用户将收到他们在传输队列中拥有的所有作业。 下表列出了枚举选项。

选项 含义
BG_JOB_ENUM_ALL_USERS
包括传输队列中的所有作业- 用户拥有的作业和其他人拥有的作业。 用户必须是管理员才能使用此标志。

[out] ppEnum

用于枚举传输队列中的作业的 IEnumBackgroundCopyJobs 接口指针。 枚举器的内容取决于 dwFlags 的值。 完成后释放 ppEnumJobs

返回值

此方法返回以下 HRESULT 值以及其他值。

返回代码 说明
S_OK
已成功生成枚举器对象。
E_ACCESSDENIED
用户必须是管理员或属于管理员组才能枚举其他用户拥有的作业。

要求

要求
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyJob::EnumFiles

IBackgroundCopyManager::GetJob

IEnumBackgroundCopyJobs