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
S_OK	Il processo è stato annullato correttamente.
BG_S_UNABLE_TO_DELETE_FILES	Il processo è stato annullato correttamente; Tuttavia, il servizio non è riuscito a eliminare i file temporanei associati al processo.
BG_E_INVALID_STATE	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

Vedi anche

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend