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