IBackgroundCopyJob::SetNotifyInterface-Methode
Identifiziert Ihre Implementierung der IBackgroundCopyCallback-Schnittstelle zur Ü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 Zeiger der Benachrichtigungsschnittstelle 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 erhalten möchten.
Die Benachrichtigungsschnittstelle wird ungü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. Wenn Sie Status- und Statusinformationen erfassen müssen, die seit der letzten Ausführung der Anwendung aufgetreten sind, rufen Sie während der Anwendungsinitialisierung Status- und Statusinformationen ab.
Nur der Auftragsbesitzer/Ersteller oder ein Administrator kann sich für Benachrichtigungen registrieren.
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_IBackgroundCopyJob ist definiert als 37668D37-507E-4160-9316-26306D150B12 |