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 |