IBackgroundCopyJob::SetNotifyInterface-Methode

Identifiziert Ihre Implementierung der IBackgroundCopyCallback-Schnittstelle für Übermittlungsoptimierung. Verwenden Sie die IBackgroundCopyCallback-Schnittstelle, um Benachrichtigungen über auftragsbezogene Ereignisse zu erhalten.

Syntax

HRESULT SetNotifyInterface(
   IUnknown *pNotifyInterface
);

Parameter

pNotifyInterface

Ein IBackgroundCopyCallback-Schnittstellenzeiger. Um den aktuellen Rückrufschnittstellenzeiger zu entfernen, legen Sie diesen Parameter auf NULL fest.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Rückgabecode Beschreibung
S_OK S_OK
Der Benachrichtigungsschnittstellenzeiger wurde erfolgreich festgelegt.

Bemerkungen

Rufen Sie diese Methode nur auf, wenn Sie die IBackgroundCopyCallback-Schnittstelle implementieren. Verwenden Sie die SetNotifyInterface-Methode in Verbindung mit der SetNotifyFlags-Methode, um den Typ der Benachrichtigung anzugeben, die Sie empfangen möchten.

Die Benachrichtigungsschnittstelle wird ungültig, wenn Ihre Anwendung beendet wird. Übermittlungsoptimierung die Benachrichtigungsschnittstelle nicht beibehalten. 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. Wenn Sie Zustands- und Fortschrittsinformationen erfassen müssen, die seit der letzten Ausführung der Anwendung aufgetreten sind, sollten Sie während der Anwendungsin initialisierung Status- und Statusinformationen erhalten.

Nur der Besitzer/Ersteller des Auftrags oder ein Administrator kann sich für Benachrichtigungen registrieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 10 Desktop-Apps, Version 1709 []
Unterstützte Mindestversion (Server)
Windows Server, version 1709 desktop apps only (Nur [ Desktop-Apps der Version 1709)]
Header
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
Bibliothek
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob ist als 37668D37-507E-4160-9316-26306D150B12 definiert.

Weitere Informationen

IBackgroundCopyJob

IBackgroundCopyCallback

IBackgroundCopyJob::GetNotifyInterface

IBackgroundCopyJob::SetNotifyFlags