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 terminator。

[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：：履歷