IBackgroundCopyManager::EnumJobs 方法 (bits.h)

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

Syntax

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

参数

[in] dwFlags

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

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

[out] ppEnum

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

返回值

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

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

要求

Requirement 价值
最低支持的客户端 Windows XP
支持的最低服务器 Windows Server 2003
目标平台 Windows操作系统
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyJob::EnumFiles

IBackgroundCopyManager::GetJob

IEnumBackgroundCopyJobs