IBackgroundCopyJob：：AddFile 方法 (bits.h)

將單一檔案新增至作業。

語法

HRESULT AddFile(
  [in] LPCWSTR RemoteUrl,
  [in] LPCWSTR LocalName
);

[in] RemoteUrl

Null 終止的字串，其中包含伺服器上的檔名。如需指定遠端名稱的資訊，請參閱 BG_FILE_INFO 結構的 RemoteName 成員和備註一節。

[in] LocalName

Null 終止的字串，其中包含用戶端上的檔名。如需指定本機名稱的詳細資訊，請參閱 BG_FILE_INFO 結構的LocalName成員和一節。

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

傳回碼	Description
S_OK	已成功將檔案新增至作業。
BG_E_TOO_MANY_FILES	上傳作業只能包含一個檔案;您無法將另一個檔案新增至作業。
BG_E_TOO_MANY_FILES_IN_JOB	MaxFilesPerJob 群組原則設定會決定作業可以包含的檔案數目。將檔案新增至作業超過 MaxFilesPerJob 限制。
E_INVALIDARG	基於下列其中一個原因，您可以收到此錯誤：本機或遠端檔名無效。遠端檔名會使用不支援的通訊協定。本機檔名是使用相對路徑來指定。
E_ACCESSDENIED	用戶沒有寫入用戶端上指定目錄的許可權。

若要一次將多個檔案新增至作業，請呼叫 IBackgroundCopyJob：：AddFileSet 方法。將多個檔案新增至作業時呼叫 AddFileSet 方法比在迴圈中呼叫 AddFile 方法更有效率。如需詳細資訊，請參閱將檔案新增至作業。

若要將檔案新增至 BITS 從檔案下載數據範圍的工作，請呼叫 IBackgroundCopyJob3：：AddFileWithRanges 方法。

上傳作業只能包含一個檔案。如果您新增第二個檔案，方法會傳回BG_E_TOO_MANY_FILES。

對於下載，BITS 保證檔案版本會根據檔案大小和日期 (，而不是其傳輸的內容) 一致;不過，它不保證一組檔案會一致。例如，如果 BITS 在作業中下載作業中兩個檔案的第二個檔案在伺服器上更新時，BITS 會重新啟動第二個檔案的下載;不過，不會再次下載第一個檔案。

請注意，如果您擁有從伺服器下載的檔案，您應該為每個新版本的檔案建立新的 URL。如果您針對新版檔案使用相同的 URL，某些 Proxy 伺服器可能會從其快取中提供過時的數據，因為它們不會在檔案過時時向原始伺服器進行驗證。

對於上傳，如果本機檔案在傳輸時變更，BITS 會產生錯誤。錯誤碼BG_E_FILE_CHANGED且內容BG_ERROR_CONTEXT_LOCAL_FILE。

BITS 會循序傳輸作業內的檔案。如果傳輸檔案時發生錯誤，作業會移至錯誤狀態，而且作業內不會再處理任何檔案，直到錯誤解決為止。

根據預設，用戶可以將最多 200 個檔案新增至作業。此限制不適用於系統管理員或服務帳戶。若要變更預設值，請設定 MaxFilesPerJob 組策略。

在 Windows Vista 之前： 用戶可以新增至作業的檔案數目沒有限制。

如需延展性考慮，請參閱使用BITS時的最佳做法。

如需將單一檔案新增至作業的範例，請參閱將檔案新增至作業。