Metodo IBackgroundCopyCallback2::FileTransferred (bits3_0.h)
BITS chiama l'implementazione del metodo FileTransferred quando BITS completa correttamente il trasferimento di un file.
Sintassi
HRESULT FileTransferred(
[in] IBackgroundCopyJob *pJob,
[in] IBackgroundCopyFile *pFile
);
Parametri
[in] pJob
Contiene informazioni correlate al processo. Non rilasciare pJob; BITS rilascia l'interfaccia quando termina questo metodo.
[in] pFile
Contiene informazioni relative ai file. Non rilasciare pFile; BITS rilascia l'interfaccia quando termina questo metodo.
Valore restituito
Questo metodo deve restituire S_OK; in caso contrario, bitS continua a chiamare questo metodo fino a quando non viene restituito S_OK. Per motivi di prestazioni, è consigliabile limitare il numero di volte in cui si restituisce un valore diverso da S_OK a poche volte. In alternativa alla restituzione di un codice di errore, è consigliabile restituire sempre S_OK e gestire internamente l'errore. L'intervallo in cui viene chiamato questo metodo è arbitrario.
Commenti
In genere, non si userebbe questo callback a meno che non si voglia convalidare il contenuto del file scaricato. La convalida del file può essere importante se si scarica contenuto che potrebbe essere servito ai peer.
Per ottenere il nome del file temporaneo contenente il contenuto scaricato, chiamare il metodo IBackgroundCopyFile3::GetTemporaryName . Dopo aver verificato il contenuto, chiamare il metodo IBackgroundCopyFile3::SetValidationState per indicare a BITS se il contenuto del file è valido. Se si imposta lo stato di convalida su FALSE e il contenuto proviene dal server di origine, il processo passa allo stato di errore.
Se il contenuto proviene da un peer, BITS scarica il file dal server di origine. Il callback viene chiamato di nuovo al termine del trasferimento del file dal server di origine.
BITS 3.0: Il callback non viene chiamato di nuovo al termine del trasferimento del file dal server di origine.
Per un processo, i callback FileTransferred vengono serializzati. BITS non invierà un callback per il file successivo nel processo finché il callback corrente non viene restituito correttamente.
I callback FileTransferred vengono inviati prima dei callback JobTransferred e JobError.
Il callback FileTransferred è per i processi di download o la parte di risposta di un processo upload-reply.
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 |