IBackgroundCopyJob::SetNotifyFlags-Methode

Gibt den Typ der Ereignisbenachrichtigung an, die Sie erhalten möchten, z. B. auftragsbasierte Ereignisse.

Syntax

HRESULT SetNotifyFlags(
  [in] ULONG NotifyFlags
);

NotifyFlags [in]

Legen Sie mindestens eins der folgenden Flags fest, um die Ereignisse zu identifizieren, die Sie empfangen möchten.

Wert	Bedeutung
BG_NOTIFY_JOB_TRANSFERRED 0x0001	Alle Dateien im Auftrag wurden übertragen.
BG_NOTIFY_JOB_ERROR 0x0002	Es ist ein Fehler aufgetreten.
BG_NOTIFY_DISABLE 0x0004	Wird nicht unterstützt.
BG_NOTIFY_JOB_MODIFICATION 0x0008	Der Auftrag wurde geändert. Beispielsweise hat sich ein Eigenschaftswert geändert, der Status des Auftrags wurde geändert, oder es wird ein Fortschritt beim Übertragen der Dateien gemacht. Dieses Flag wird ignoriert, wenn die Befehlszeilenbenachrichtigung angegeben ist.
BG_NOTIFY_FILE_TRANSFERRED 0x0010	Eine Datei im Auftrag wurde übertragen. Dieses Flag wird ignoriert, wenn die Befehlszeilenbenachrichtigung angegeben ist.
BG_NOTIFY_FILE_RANGES_TRANSFERRED 0x0020	Wird nicht unterstützt.

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

Rückgabecode	Beschreibung
S_OK	Der Typ der Ereignisbenachrichtigung wurde erfolgreich festgelegt.
DO_E_INVALID_STATE	Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED werden.

Verwenden Sie die SetNotifyFlags-Methode in Verbindung mit dem IBackgroundCopyJob::SetNotifyInterface.

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	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Bibliothek	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyJob ist definiert als 37668D37-507E-4160-9316-26306D150B12