Metodo IBackgroundCopyFile3::SetValidationState (bits3_0.h)

Imposta lo stato di convalida del file.

Sintassi

HRESULT SetValidationState(
  [in] BOOL state
);

Parametri

[in] state

Impostare su TRUE se il contenuto del file è valido; in caso contrario, FALSE.

Valore restituito

Il metodo restituisce i valori restituiti seguenti.

Codice restituito	Descrizione
S_OK	Operazione riuscita
E_PENDING	Non è possibile convalidare il file fino al completamento del download.
BG_E_RECORD_DELETED	Il record memorizzato nella cache associato a questo file è stato eliminato.

Commenti

Se si imposta lo stato di convalida su FALSE e il file è stato scaricato dal server di origine, il processo passa allo stato di errore con un codice di errore di BG_E_VALIDATION_FAILED e lo stato del file è impostato su zero. È quindi possibile chiamare il metodo IBackgroundCopyJob::Resume per scaricare nuovamente il file.

BITS 3.0: Non chiamare il metodo IBackgroundCopyJob::Resume per scaricare nuovamente il file. Chiamare invece il metodo IBackgroundCopyJob::Complete o IBackgroundCopyJob::Cancel per pulire il processo corrente e quindi creare un nuovo processo per scaricare il file.

Se si imposta lo stato di convalida su FALSE e il file è stato scaricato da un peer, BITS rimuove il file dalla cache, reimposta lo stato di avanzamento del file su zero e scarica nuovamente il file dal server di origine.

È possibile chiamare questo metodo solo dopo che BITS termina il trasferimento del file. Per ricevere una notifica al termine del trasferimento, implementare il metodo IBackgroundCopyCallback2::FileTransferred .

La chiamata al metodo IBackgroundCopyJob::Complete convalida in modo implicito il file.

Se si convalida un file nella cache e quindi si chiama IBackgroundCopyJob4::SetPeerCachingFlags per disabilitare la memorizzazione nella cache (o la memorizzazione nella cache peer viene disabilitata tramite Criteri di gruppo), il file rimane nella cache. Se si disabilita la memorizzazione nella cache prima di convalidare il file, BITS rimuove il file dalla cache.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	bits3_0.h (include Bits.h)
Libreria	Bits.lib

Vedi anche

IBackgroundCopyFile3

IBackgroundCopyFile3::GetValidationState

IBitsPeerCacheRecord::IsFileValidated