IBackgroundCopyJob-Schnittstelle

  • Artikel

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.

Member

Die IBackgroundCopyJob-Schnittstelle erbt von der IUnknown-Schnittstelle . IBackgroundCopyJob verfügt auch über folgende Arten 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 Auflisten 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 Dauer ab, die die Übermittlungsoptimierung weiterhin versucht, die Datei zu übertragen, nachdem eine vorübergehende Fehlerbedingung aufgetreten ist.
GetNotifyFlags Ruft die Flags für Ereignisbenachrichtigungen (Rückruf) 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ätsebene ab, die Sie für den Auftrag festgelegt haben.
GetProgress Ruft auftragsbezogene Statusinformationen ab, z. B. die Anzahl der 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 durchgeführten Übertragung ab, z. B. einen Dateidownload.
Fortsetzen Startet einen neuen Auftrag oder startet einen angehaltenen Auftrag neu.
SetNoProgressTimeout Gibt die Dauer an, die 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 im Verhältnis zu anderen Aufträgen in der Übertragungswarteschlange an.
Angehalten Hält den Auftrag an.

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
IDL
DeliveryOptimization.idl
Bibliothek
Dosvc.lib
DLL
Dosvc.dll
IID
 IID_IBackgroundCopyJob ist definiert als 37668D37-507E-4160-9316-26306D150B12

Siehe auch

IBackgroundCopyFile

IBackgroundCopyManager