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

傳回碼	Description
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
程式庫	Bits.lib
Dll	QmgrPrxy.dll

另請參閱

建立作業

IBackgroundCopyJob

IBackgroundCopyJob：：Resume