IBackgroundCopyJob-Schnittstelle

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

Rufen Sie zum Erstellen eines Auftrags die IBackgroundCopyManager::CreateJob-Methode auf. Rufen Sie die IBackgroundCopyManager::GetJob-Methode auf, um einen IBackgroundCopyJob-Schnittstellenzeiger auf einen vorhandenen Auftrag abzurufen.

Member

Die IBackgroundCopyJob-Schnittstelle erbt von der IUnknown-Schnittstelle. IBackgroundCopyJob verfügt auch über diese Typen von Membern:

Methoden

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

Methode BESCHREIBUNG
Abbrechen Bricht den Auftrag ab und entfernt temporäre Dateien vom Client.
Abgeschlossen Beendet den Auftrag und speichert die übertragenen Dateien auf dem Client.
EnumFiles Gibt einen Schnittstellenzeiger auf ein Enumeratorobjekt zurück, das Sie zum Aufzählen der Dateien im Auftrag verwenden.
GetDisplayName Ruft den Anzeigenamen ab, der den Auftrag identifiziert.
GetError Ruft einen Schnittstellenzeiger auf das Fehlerobjekt ab, nachdem ein Fehler aufgetreten ist.
Getid Ruft den Bezeichner des Auftrags in der Warteschlange ab.
GetNoProgressTimeout Ruft die Zeitspanne ab, die Übermittlungsoptimierung weiterhin versucht, die Datei zu übertragen, nachdem eine vorübergehende Fehlerbedingung aufgetreten ist.
GetNotifyFlags Ruft die Ereignisbenachrichtigungsflags (Rückrufflags) ab, die Sie für Ihre Anwendung festgelegt haben.
GetNotifyInterface Ruft einen Zeiger auf Ihre Implementierung der IBackgroundCopyCallback-Schnittstelle (Rückrufe) ab.
GetPriority Ruft die Prioritätsstufe ab, die Sie für den Auftrag festgelegt haben.
GetProgress Ruft auftragsbezogene Statusinformationen ab, z. B. die Anzahl von Bytes und Dateien, die an den Client übertragen werden.
GetState Ruft den Status des Auftrags ab.
GetTimes Ruft Zeitstempel für Aktivitäten im Zusammenhang mit dem Auftrag ab, z. B. die Zeit, zu der der Auftrag erstellt wurde.
Gettype Ruft den Typ der übertragung ab, die ausgeführt wird, z. B. ein Dateidownload.
Fortsetzen Startet einen neuen Auftrag oder startet einen angehaltenen Auftrag neu.
SetNoProgressTimeout Gibt die Zeitspanne an, die Übermittlungsoptimierung weiterhin versucht, die Datei zu übertragen, nachdem eine vorübergehende Fehlerbedingung aufgetreten ist.
SetNotifyFlags Gibt den Typ der zu empfangenden Ereignisbenachrichtigung an.
SetNotifyInterface Gibt einen Zeiger auf Ihre Implementierung der IBackgroundCopyCallback-Schnittstelle (Rückrufe) an. Die Schnittstelle empfängt Benachrichtigungen basierend auf den von Ihnen festgelegten Ereignisbenachrichtigungsflags.
SetPriority Gibt die Priorität des Auftrags relativ zu anderen Aufträgen in der Übertragungswarteschlange an.
Angehalten Hält den Auftrag an.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 10, nur Desktop-Apps der Version 1709 []
Unterstützte Mindestversion (Server)
Windows Server, nur Desktop-Apps der Version 1709 []
Header
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Bibliothek
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob ist als 37668D37-507E-4160-9316-26306D150B12 definiert.

Weitere Informationen

IBackgroundCopyFile

IBackgroundCopyManager