IBackgroundCopyManager：：CreateJob 方法

建立作業。

語法

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

參數

pDisplayName [in]

Null 終止的字串，其中包含作業的顯示名稱。 一般而言，顯示名稱是用來識別使用者介面中的作業。 請注意，多個作業可能具有相同的顯示名稱。 不得為 Null。 名稱限制為 256 個字元，不包括 Null 結束字元。

輸入 [in]

傳輸作業的類型，例如BG_JOB_TYPE_DOWNLOAD。 如需傳輸類型清單，請參閱 BG_JOB_TYPE 列舉。

pJobID [out]

可唯一識別佇列中的作業。 當您呼叫 IBackgroundCopyManager：：GetJob 方法以從佇列取得作業時，請使用此識別碼。

ppJob [out]

您用來修改作業屬性的 IBackgroundCopyJob 介面指標，並指定要傳輸的檔案。 若要在佇列中啟動作業，請呼叫 IBackgroundCopyJob：：Resume 方法。 完成時釋放 ppJob 。

傳回值

這個方法會傳回下列 HRESULT 值，以及其他值。

備註

只有建立作業的使用者或具有系統管理員許可權的使用者，才能 將檔案新增至作業 ，並 變更作業的屬性。

規格需求

另請參閱

IBackgroundCopyManager

IBackgroundCopyJob

IBackgroundCopyJob：：Resume