IBackgroundCopyManager：：CreateJob 方法 (bits.h)

  • 项目

创建作业。

语法

HRESULT CreateJob(
  [in]  LPCWSTR            DisplayName,
  [in]  BG_JOB_TYPE        Type,
  [out] GUID               *pJobId,
  [out] IBackgroundCopyJob **ppJob
);

参数

[in] DisplayName

以 Null 结尾的字符串，其中包含作业的显示名称。 通常，显示名称用于在用户界面中标识作业。 请注意，多个作业可能具有相同的显示名称。 不得为 NULL。 名称限制为 256 个字符，不包括 null 终止符。

[in] Type

传输作业的类型，例如BG_JOB_TYPE_DOWNLOAD。 有关传输类型的列表，请参阅 BG_JOB_TYPE 枚举。

[out] pJobId

唯一标识队列中的作业。 调用 IBackgroundCopyManager：：GetJob 方法从队列中获取作业时使用此标识符。

[out] ppJob

IBackgroundCopyJob 接口指针，用于修改作业的属性并指定要传输的文件。 若要激活队列中的作业，请调用 IBackgroundCopyJob：：Resume 方法。 完成后释放 ppJob 。

返回值

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

返回代码 说明
S_OK
 已成功生成新作业。
E_INVALIDARG
 显示名称太长。
BG_E_TOO_MANY_JOBS_PER_MACHINE
 MaxJobsPerMachine 组策略 设置确定计算机上可以创建多少个作业。 添加此作业超出了 MaxJobsPerMachine 限制。
BG_E_TOO_MANY_JOBS_PER_USER
 MaxJobsPerUser 组策略设置确定用户可以创建的作业数。 添加此作业超出了 MaxJobsPerUser 限制。

注解

只有创建作业的用户或具有管理员权限的用户才能 将文件添加到作业 并 更改作业的属性。

默认情况下，BITS 一次最多支持 300 个作业。 单个用户一次最多可以创建 60 个作业。 用户限制不适用于管理员或服务帐户。 若要更改这些默认值，请分别设置 MaxJobsPerMachine 和 MaxJobsPerUser 组策略。

在 Windows Vista 之前： BITS 支持或用户可以创建的作业数没有限制。

有关可伸缩性问题，请参阅 使用 BITS 时的最佳做法。

示例

有关创建新作业的示例，请参阅 创建作业。

要求

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

另请参阅

创建作业

IBackgroundCopyJob

IBackgroundCopyJob：：Resume