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 |
|---|---|
|
Operazione riuscita |
|
Non è possibile convalidare il file fino al completamento del download. |
|
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 |