IBackgroundCopyCallback3-Schnittstelle (bits10_1.h)
Clients implementieren die IBackgroundCopyCallback3-Schnittstelle , um Benachrichtigungen zu erhalten, dass bereiche einer Datei den Download abgeschlossen haben.
Anstatt nach dem Download status einer Datei zu suchen, verwenden Clients diese Schnittstelle. Rufen Sie zum Empfangen von Benachrichtigungen die IBackgroundCopyJob::SetNotifyInterface-Methode auf, um den Schnittstellenzeiger auf Ihre IBackgroundCopyCallback-Implementierung anzugeben. Um anzugeben, welche Benachrichtigungen Sie empfangen möchten, rufen Sie die IBackgroundCopyJob::SetNotifyFlags-Methode auf. Sie müssen alle Methoden dieser Schnittstelle und der IBackgroundCopyCallback2 - und IBackgroundCopyCallback-Schnittstelle implementieren. Wenn Sie sich beispielsweise nicht für den dateiüberwiesenen Rückruf registrieren, muss Ihre FileTransferred-Methode weiterhin S_OK zurückgeben. Wenn Sie den übertragenen Dateibereichsrückruf nicht erhalten möchten, können Sie stattdessen einfach IBackgroundCopyCallback oder IBackgroundCopyCallback2 implementieren.
Vererbung
Die IBackgroundCopyCallback3-Schnittstelle erbt von IBackgroundCopyCallback und IBackgroundCopyCallback2. IBackgroundCopyCallback3 verfügt auch über folgende Arten von Membern:
Methoden
Die IBackgroundCopyCallback3-Schnittstelle verfügt über diese Methoden.
| IBackgroundCopyCallback3::FileRangesTransferred BITS ruft Ihre Implementierung der FileRangesTransferred-Methode auf, wenn mindestens ein Dateibereich heruntergeladen wurde. Dateibereiche werden dem Auftrag mithilfe der IBackgroundCopyFile6::RequestFileRanges-Methode hinzugefügt. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1703 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | bits10_1.h (Bits.h einschließen) |