IBackgroundCopyFile3：：SetValidationState 方法 (bits3_0.h)

設定這個檔案的驗證狀態。

語法

HRESULT SetValidationState(
  [in] BOOL state
);

[in] state

如果檔案內容有效，則設定為 TRUE ，否則為 FALSE。

方法會傳回下列傳回值。

如果您將驗證狀態設定為 FALSE ，而且檔案是從源伺服器下載的，則作業會移至錯誤狀態，錯誤碼為 BG_E_VALIDATION_FAILED，並將檔案進度設定為零。然後，您可以呼叫 IBackgroundCopyJob：：Resume 方法來再次下載檔案。

BITS 3.0： 請勿呼叫 IBackgroundCopyJob：：Resume 方法來再次下載檔案。請改為呼叫 IBackgroundCopyJob：：Complete 或 IBackgroundCopyJob：：Cancel 方法來清除目前的作業，然後建立新作業以下載檔。

如果您將驗證狀態設定為 FALSE ，而且檔案是從對等下載的，BITS 會從快取中移除檔案、將檔案進度重設為零，並從源伺服器再次下載檔案。

您只能在 BITS 完成傳輸檔案之後呼叫這個方法。若要在傳輸完成時接收通知，請實作 IBackgroundCopyCallback2：：FileTransferred 方法。

呼叫 IBackgroundCopyJob：：Complete 方法會隱含地驗證檔案。

如果您在快取中驗證檔案，然後呼叫 IBackgroundCopyJob4：：SetPeerCachingFlags 來停用快取 (或對等快取會透過群組原則) 停用，檔案會保留在快取中。如果您在驗證檔案之前停用快取，BITS 會從快取中移除檔案。