Metodo IBackgroundCopyJob::Cancel (bits.h)
Elimina il processo dalla coda di trasferimento e rimuove i file temporanei correlati dal client (download) e dal server (caricamenti).
Sintassi
HRESULT Cancel();
Valore restituito
Questo metodo restituisce i valori HRESULT seguenti, nonché altri.
| Codice restituito | Descrizione |
|---|---|
|
Il processo è stato annullato correttamente. |
|
Il processo è stato annullato correttamente; Tuttavia, il servizio non è riuscito a eliminare i file temporanei associati al processo. |
|
Impossibile annullare un processo il cui stato è BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED. |
Commenti
È possibile annullare un processo in qualsiasi momento; Tuttavia, il processo non può essere ripristinato dopo l'annullamento.
Per i processi di caricamento, se il server non è disponibile, potrebbe verificarsi un ritardo prima che BITS elimini il processo dalla coda. BITS invia periodicamente una richiesta di annullamento al server BITS per un massimo di 24 ore. Se il server non risponde entro il periodo di 24 ore, BITS rimuove il processo dalla coda. Se il periodo di timeout senza avanzamento è inferiore a 24 ore, BITS usa il periodo di timeout senza avanzamento per limitare i tentativi.
Il metodo Cancel annulla un caricamento se il caricamento non è completato. Se il caricamento è completato e il processo è di tipo BG_JOB_TYPE_UPLOAD_REPLY, il metodo annulla la risposta.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP |
| Server minimo supportato | Windows Server 2003 |
| Piattaforma di destinazione | Windows |
| Intestazione | bits.h |
| Libreria | Bits.lib |
| DLL | QmgrPrxy.dll |