IBackgroundCopyManager：：CreateJob 方法 （bits.h）

创建作业。

Syntax

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 值以及其他值。

注解

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

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

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

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

例子

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

要求

另请参阅

创建作业

IBackgroundCopyJob

IBackgroundCopyJob：：Resume