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 |
|---|---|
|
Der Auftrag wurde erfolgreich abgebrochen. |
|
Auftrag wurde erfolgreich abgebrochen; Der Dienst konnte jedoch die dem Auftrag zugeordneten temporären Dateien nicht löschen. |
|
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 |