BG_JOB_STATE Enumeration (bits.h)

  • Artikel

Definiert Konstanten, die die verschiedenen Zustände eines Auftrags angeben.

Syntax

typedef enum BG_JOB_STATE {
  BG_JOB_STATE_QUEUED = 0,
  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
} ;

Konstanten

 
BG_JOB_STATE_QUEUED
Wert: 0
Gibt an, dass sich der Auftrag in der Warteschlange befindet und auf die Ausführung wartet. Wenn sich ein Benutzer während der Übertragung des Auftrags abmeldet, wechselt der Auftrag in den Zustand der Warteschlange.
BG_JOB_STATE_CONNECTING
Gibt an, dass BITS versucht, eine Verbindung mit dem Server herzustellen. Wenn die Verbindung erfolgreich ist, wird der Status des Auftrags BG_JOB_STATE_TRANSFERRING. andernfalls wird der Zustand BG_JOB_STATE_TRANSIENT_ERROR.
BG_JOB_STATE_TRANSFERRING
Gibt an, dass BITS 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. BITS setzt einen Auftrag automatisch an, wenn er erstellt wird. Der Auftrag bleibt angehalten, bis Sie die IBackgroundCopyJob::Resume-Methode, die IBackgroundCopyJob::Complete-Methode oder die IBackgroundCopyJob::Cancel-Methode 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 – korrigiert werden kann, rufen Sie die
IBackgroundCopyJob::Resume-Methode nachdem der Fehler behoben wurde. Wenn der Fehler jedoch nicht behoben werden kann, rufen Sie die
IBackgroundCopyJob::Cancel-Methode , um den Auftrag abzubrechen oder die
IBackgroundCopyJob::Complete-Methode , um den Teil eines Downloadauftrags zu akzeptieren, der erfolgreich übertragen wurde.
BG_JOB_STATE_TRANSIENT_ERROR
Gibt an, dass ein wiederherstellbarer Fehler aufgetreten ist. BITS wiederholt Aufträge im Zustand vorübergehender Fehler basierend auf dem von Ihnen angegebenen Wiederholungsintervall (siehe IBackgroundCopyJob::SetMinimumRetryDelay-Methode). Der Status des Auftrags ändert sich in BG_JOB_STATE_ERROR , wenn der Auftrag keinen Fortschritt macht (siehe IBackgroundCopyJob::SetNoProgressTimeout-Methode).

BITS versucht den Auftrag nicht erneut, chkdsk wenn eine Netzwerkverbindung oder ein Fehler bei der Datenträgersperre aufgetreten ist (z. B. wird ausgeführt), oder die MaxInternetBandwidth-Gruppenrichtlinie ist 0.
BG_JOB_STATE_TRANSFERRED
Gibt an, dass Ihr Auftrag erfolgreich verarbeitet wurde. Sie müssen den
IBackgroundCopyJob::Complete-Methode , um den Abschluss des Auftrags zu bestätigen und die Dateien dem Client zur Verfügung zu stellen.
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 aufgerufen haben
IBackgroundCopyJob::Cancel-Methode , um den Auftrag abzubrechen (d. a. um den Auftrag aus der Übertragungswarteschlange zu entfernen).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP
Unterstützte Mindestversion (Server) Windows Server 2003
Kopfzeile bits.h

Weitere Informationen