IBackgroundCopyCallback-Schnittstelle
Implementieren Sie die IBackgroundCopyCallback-Schnittstelle , um eine Benachrichtigung zu erhalten, dass ein Auftrag abgeschlossen ist, geändert wurde oder fehlerhaft ist. Clients verwenden diese Schnittstelle, anstatt die status des Auftrags zu abfragen.
Member
Die IBackgroundCopyCallback-Schnittstelle erbt von der IUnknown-Schnittstelle . IBackgroundCopyCallback verfügt auch über folgende Membertypen:
Methoden
Die IBackgroundCopyCallback-Schnittstelle verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| JobError | Wird aufgerufen, wenn ein Fehler auftritt. |
| JobModification | Wird aufgerufen, wenn ein Auftrag geändert wird. |
| JobTransferred | Wird aufgerufen, wenn alle Dateien im Auftrag erfolgreich übertragen wurden. |
Bemerkungen
Rufen Sie zum Empfangen von Benachrichtigungen die IBackgroundCopyJob::SetNotifyInterface-Methode auf, um den Schnittstellenzeiger auf Ihre IBackgroundCopyCallback-Implementierung anzugeben. Um anzugeben, welche Benachrichtigungen Sie erhalten möchten, rufen Sie die IBackgroundCopyJob::SetNotifyFlags-Methode auf.
Die Übermittlungsoptimierung ruft Ihre Rückrufe auf, solange der Schnittstellenzeiger gültig ist. Die Benachrichtigungsschnittstelle ist nicht mehr gültig, wenn Ihre Anwendung beendet wird. Die Übermittlungsoptimierung speichert die Benachrichtigungsschnittstelle nicht. Daher sollte der Initialisierungsprozess Ihrer Anwendung die SetNotifyInterface-Methode für die vorhandenen Aufträge aufrufen, für die Sie eine Benachrichtigung erhalten möchten.
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_IBackgroundCopyCallback ist definiert als 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22 |