IBackgroundCopyJob::Cancel-Methode (bits.h)

Löscht den Auftrag aus der Übertragungswarteschlange und entfernt die zugehörigen temporären Dateien vom Client (Downloads) und server (Uploads).

Syntax

HRESULT Cancel();

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Rückgabecode	Beschreibung
S_OK	Der Auftrag wurde erfolgreich abgebrochen.
BG_S_UNABLE_TO_DELETE_FILES	Auftrag wurde erfolgreich abgebrochen; Der Dienst konnte jedoch die dem Auftrag zugeordneten temporären Dateien nicht löschen.
BG_E_INVALID_STATE	Ein Auftrag, dessen Status BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED ist, kann nicht abgebrochen werden.

Hinweise

Sie können einen Auftrag jederzeit abbrechen . Der Auftrag kann jedoch nicht wiederhergestellt werden, nachdem er abgebrochen wurde.

Wenn der Server bei Uploadaufträgen nicht verfügbar ist, kann es zu einer Verzögerung kommen, bevor BITS den Auftrag aus der Warteschlange löscht. BITS sendet in regelmäßigen Abständen bis zu 24 Stunden eine Abbruchanforderung an den BITS-Server. Wenn der Server nicht innerhalb des 24-Stunden-Zeitraums antwortet, entfernt BITS den Auftrag aus der Warteschlange. Wenn der Timeoutzeitraum ohne Fortschritt weniger als 24 Stunden beträgt, verwendet BITS den Timeoutzeitraum ohne Fortschritt, um die Wiederholungen zu begrenzen.

Die Cancel-Methode bricht einen Upload ab, wenn der Upload nicht abgeschlossen ist. Wenn der Upload abgeschlossen ist und der Auftrag vom Typ BG_JOB_TYPE_UPLOAD_REPLY ist, bricht die -Methode die Antwort ab.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	bits.h
Bibliothek	Bits.lib
DLL	QmgrPrxy.dll

Weitere Informationen

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend