IBackgroundCopyJob-Schnittstelle
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 |
|
| IDL |
|
| Bibliothek |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob ist definiert als 37668D37-507E-4160-9316-26306D150B12 |