Freigeben über


IBackgroundCopyJob-Schnittstelle (bits.h)

Verwenden Sie die IBackgroundCopyJob-Schnittstelle , um dem Auftrag Dateien hinzuzufügen, die Prioritätsebene des Auftrags festzulegen, den Status des Auftrags zu bestimmen und den Auftrag zu starten und zu beenden.

Um einen Auftrag zu erstellen, rufen Sie die IBackgroundCopyManager::CreateJob-Methode auf. Um einen IBackgroundCopyJob-Schnittstellenzeiger auf einen vorhandenen Auftrag abzurufen, rufen Sie die IBackgroundCopyManager::GetJob-Methode auf.

Vererbung

Die IBackgroundCopyJob-Schnittstelle erbt von der IUnknown-Schnittstelle . IBackgroundCopyJob verfügt auch über folgende Membertypen:

Methoden

Die IBackgroundCopyJob-Schnittstelle verfügt über diese Methoden.

 
IBackgroundCopyJob::AddFile

Fügt dem Auftrag eine einzelne Datei hinzu.
IBackgroundCopyJob::AddFileSet

Fügt einem Auftrag mehrere Dateien hinzu.
IBackgroundCopyJob::Cancel

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

Beendet den Auftrag und speichert die übertragenen Dateien auf dem Client.
IBackgroundCopyJob::EnumFiles

Ruft einen IEnumBackgroundCopyFiles-Schnittstellenzeiger ab, den Sie zum Aufzählen der Dateien in einem Auftrag verwenden.
IBackgroundCopyJob::GetDescription

Ruft die Beschreibung des Auftrags ab.
IBackgroundCopyJob::GetDisplayName

Ruft den Anzeigenamen für den Auftrag ab. In der Regel verwenden Sie den Anzeigenamen, um den Auftrag in einer Benutzeroberfläche zu identifizieren.
IBackgroundCopyJob::GetError

Ruft die Fehlerschnittstelle ab, nachdem ein Fehler auftritt.
IBackgroundCopyJob::GetErrorCount

Ruft ab, wie oft BITS versucht hat, den Auftrag zu übertragen, und es ist ein Fehler aufgetreten.
IBackgroundCopyJob::GetId

Ruft den Bezeichner ab, der zum Identifizieren des Auftrags in der Warteschlange verwendet wird.
IBackgroundCopyJob::GetMinimumRetryDelay

Ruft die Mindestdauer ab, die der Dienst wartet, nachdem eine vorübergehende Fehlerbedingung aufgetreten ist, bevor versucht wird, die Datei zu übertragen.
IBackgroundCopyJob::GetNoProgressTimeout

Ruft die Dauer ab, für die der Dienst versucht, die Datei zu übertragen, nachdem ein vorübergehender Fehler auftritt. Wenn ein Fortschritt vorhanden ist, wird der Timer zurückgesetzt.
IBackgroundCopyJob::GetNotifyFlags

Ruft die Ereignisbenachrichtigungsflags für den Auftrag ab.
IBackgroundCopyJob::GetNotifyInterface

Ruft den Schnittstellenzeiger auf Ihre Implementierung der IBackgroundCopyCallback-Schnittstelle ab.
IBackgroundCopyJob::GetOwner

Ruft die Identität des Auftragsbesitzers ab.
IBackgroundCopyJob::GetPriority

Ruft die Prioritätsstufe für den Auftrag ab. Die Prioritätsebene bestimmt, wann der Auftrag relativ zu anderen Aufträgen in der Übertragungswarteschlange verarbeitet wird.
IBackgroundCopyJob::GetProgress

Ruft auftragsbezogene Statusinformationen ab, z. B. die Anzahl der übertragenen Bytes und Dateien.
IBackgroundCopyJob::GetProxySettings

Ruft die Proxyinformationen ab, die der Auftrag zum Übertragen der Dateien verwendet.
IBackgroundCopyJob::GetState

Ruft den Status des Auftrags ab.
IBackgroundCopyJob::GetTimes

Ruft auftragsbezogene Zeitstempel ab, z. B. den Zeitpunkt, zu dem der Auftrag erstellt oder zuletzt geändert wurde.
IBackgroundCopyJob::GetType

Ruft den Typ der ausgeführten Übertragung ab, z. B. ein Dateidownload oder -upload.
IBackgroundCopyJob::Resume

Aktiviert einen neuen Auftrag oder startet einen angehaltenen Auftrag neu.
IBackgroundCopyJob::SetDescription

Stellt eine Beschreibung des Auftrags bereit.
IBackgroundCopyJob::SetDisplayName

Gibt einen Anzeigenamen für den Auftrag an. In der Regel verwenden Sie den Anzeigenamen, um den Auftrag in einer Benutzeroberfläche zu identifizieren.
IBackgroundCopyJob::SetMinimumRetryDelay

Legt die Mindestdauer fest, die BITS nach auftreten einer vorübergehenden Fehlerbedingung wartet, bevor versucht wird, die Datei zu übertragen.
IBackgroundCopyJob::SetNoProgressTimeout

Legt die Dauer fest, für die BITS versucht, die Datei zu übertragen, nachdem ein vorübergehender Fehler auftritt. Wenn ein Fortschritt vorhanden ist, wird der Timer zurückgesetzt.
IBackgroundCopyJob::SetNotifyFlags

Gibt den Typ der Ereignisbenachrichtigung an, die Sie erhalten möchten, z. B. auftragsbasierte Ereignisse.
IBackgroundCopyJob::SetNotifyInterface

Identifiziert Ihre Implementierung der IBackgroundCopyCallback-Schnittstelle zu BITS. Verwenden Sie die IBackgroundCopyCallback-Schnittstelle, um Benachrichtigungen über auftragsbezogene Ereignisse zu erhalten.
IBackgroundCopyJob::SetPriority

Gibt die Prioritätsebene Ihres Auftrags an. Die Prioritätsebene bestimmt, wann Ihr Auftrag relativ zu anderen Aufträgen in der Übertragungswarteschlange verarbeitet wird.
IBackgroundCopyJob::SetProxySettings

Gibt an, welcher Proxy zum Übertragen von Dateien verwendet werden soll.
IBackgroundCopyJob::Suspend

Hält einen Auftrag an. Neue Aufträge, Fehleraufträge und Aufträge, die die Übertragung von Dateien abgeschlossen haben, werden automatisch angehalten.
IBackgroundCopyJob::TakeOwnership

Ändert den Besitz des Auftrags in den aktuellen Benutzer.

Anforderungen

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

Weitere Informationen

IBackgroundCopyFile

IBackgroundCopyJob2

IBackgroundCopyJob3

IBackgroundCopyManager

IEnumBackgroundCopyJobs