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