BG_JOB_STATE-Enumeration

Die BG_JOB_STATE-Enumeration definiert konstante Werte für die verschiedenen Zustände eines Auftrags.

Syntax

typedef enum  { 
  BG_JOB_STATE_QUEUED,
  BG_JOB_STATE_CONNECTING,
  BG_JOB_STATE_TRANSFERRING,
  BG_JOB_STATE_SUSPENDED,
  BG_JOB_STATE_ERROR,
  BG_JOB_STATE_TRANSIENT_ERROR,
  BG_JOB_STATE_TRANSFERRED,
  BG_JOB_STATE_ACKNOWLEDGED,
  BG_JOB_STATE_CANCELLED
} BG_JOB_STATE;

Konstanten

BG_JOB_STATE_QUEUED

Gibt an, dass sich der Auftrag in der Warteschlange befindet und auf die Ausführung wartet. Wenn sich ein Benutzer während der Auftragsübertragung abmeldet, wechselt der Auftrag in den Zustand in der Warteschlange.

BG_JOB_STATE_CONNECTING

Wird nicht unterstützt.

BG_JOB_STATE_TRANSFERRING

Gibt an, dass die Übermittlungsoptimierung Daten für den Auftrag überträgt.

BG_JOB_STATE_SUSPENDED

Gibt an, dass der Auftrag angehalten (angehalten) wird. Um einen Auftrag anzusetzen, rufen Sie die IBackgroundCopyJob::Suspend-Methode auf. Der Auftrag bleibt angehalten, bis Sie die Methode IBackgroundCopyJob::Resume, IBackgroundCopyJob::Complete oder IBackgroundCopyJob::Cancel aufrufen.

BG_JOB_STATE_ERROR

Gibt an, dass ein nicht behebbarer Fehler aufgetreten ist (der Dienst kann die Datei nicht übertragen). Wenn der Fehler, z. B. ein Zugriff verweigerter Fehler, behoben werden kann, rufen Sie die IBackgroundCopyJob::Resume-Methode auf, nachdem der Fehler behoben wurde. Wenn der Fehler jedoch nicht behoben werden kann, rufen Sie die IBackgroundCopyJob::Cancel-Methode auf, um den Auftrag abzubrechen, oder rufen Sie die IBackgroundCopyJob::Complete-Methode auf, um den Teil eines Downloadauftrags zu akzeptieren, der erfolgreich übertragen wurde.

BG_JOB_STATE_TRANSIENT_ERROR

Gibt an, dass ein wiederherstellbarer Fehler aufgetreten ist. Die Übermittlungsoptimierung führt basierend auf der internen Wiederholungskonfiguration einen Wiederholungsversuch für Aufträge im Vorübergehenden Fehlerzustand durch. Der Status des Auftrags ändert sich in BG_JOB_STATE_ERROR , wenn der Auftrag keinen Fortschritt macht (siehe IBackgroundCopyJob::SetNoProgressTimeout).

BG_JOB_STATE_TRANSFERRED

Gibt an, dass Ihr Auftrag erfolgreich verarbeitet wurde. Sie müssen die IBackgroundCopyJob::Complete-Methode aufrufen, um den Abschluss des Auftrags zu bestätigen und die Dateien für den Client verfügbar zu machen.

BG_JOB_STATE_ACKNOWLEDGED

Gibt an, dass Sie die IBackgroundCopyJob::Complete-Methode aufgerufen haben, um zu bestätigen, dass Ihr Auftrag erfolgreich abgeschlossen wurde.

BG_JOB_STATE_CANCELLED

Gibt an, dass Sie die IBackgroundCopyJob::Cancel-Methode aufgerufen haben, um den Auftrag abzubrechen (entfernen Sie den Auftrag aus der Übertragungswarteschlange).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server, Version 1709 [nur Desktop-Apps]
Header	Deliveryoptimization.h

Siehe auch

IBackgroundCopyJob::GetState