IBackgroundCopyJob::SetNotifyFlags-Methode

Gibt den Typ der Ereignisbenachrichtigung an, die Sie empfangen möchten, z. B. ereignisse, die vom Auftrag übertragen werden sollen.

Syntax

HRESULT SetNotifyFlags(
  [in] ULONG NotifyFlags
);

Parameter

NotifyFlags [ In]

Legen Sie mindestens eines 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 wurde ein Eigenschaftswert geändert, der Status des Auftrags geändert, oder der Fortschritt wird beim Übertragen der Dateien ausgeführt. Dieses Flag wird ignoriert, wenn eine Befehlszeilenbenachrichtigung angegeben wird.
BG_NOTIFY_FILE_TRANSFERRED
0x0010
Eine Datei im Auftrag wurde übertragen. Dieses Flag wird ignoriert, wenn eine Befehlszeilenbenachrichtigung angegeben wird.
BG_NOTIFY_FILE_RANGES_TRANSFERRED
0x0020
Wird nicht unterstützt.

Rückgabewert

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.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 10, nur Desktop-Apps der Version 1709 []
Unterstützte Mindestversion (Server)
Windows Server, 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::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface