Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Löscht den Auftrag aus der Übertragungswarteschlange und entfernt verwandte temporäre 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 | Description |
|---|---|
|
Der Auftrag wurde erfolgreich abgebrochen. |
|
Der Auftrag wurde erfolgreich abgebrochen; Der Dienst konnte jedoch die temporären Dateien, die dem Auftrag zugeordnet sind, nicht löschen. |
|
Ein Auftrag, dessen Status BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED ist, kann nicht abgebrochen werden. |
Bemerkungen
Sie können einen Auftrag jederzeit kündigen ; Der Auftrag kann jedoch nicht wiederhergestellt werden, nachdem er abgebrochen wurde.
Bei Uploadaufträgen, wenn der Server nicht verfügbar ist, kann es eine Verzögerung geben, bevor BITS den Auftrag aus der Warteschlange löscht. BITS sendet regelmäßig eine Abbruchanforderung für bis zu 24 Stunden an den BITS-Server. Wenn der Server nicht innerhalb des 24-Stunden-Zeitraums reagiert, entfernt BITS den Auftrag aus der Warteschlange. Wenn der Timeoutzeitraum ohne Fortschritt weniger als 24 Stunden beträgt, verwendet BITS den Zeitraum 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 |
|---|---|
| Mindestens unterstützter Client | Windows XP |
| Mindestanforderungen für unterstützte Server | Windows Server 2003 |
| Zielplattform | Fenster |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |