Freigeben über


IBackgroundCopyJob::SetNotifyFlags-Methode (bits.h)

Gibt den Typ der Ereignisbenachrichtigung an, die Sie empfangen möchten, z. B. übertragene Auftragsereignisse.

Syntax

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

Die Parameter

[in] Val

Legen Sie ein oder mehrere 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
Ein Fehler ist aufgetreten.
BG_NOTIFY_DISABLE
0x0004
Ereignisbenachrichtigung ist deaktiviert. BITS ignoriert die anderen Flags.
BG_NOTIFY_JOB_MODIFICATION
0x0008
Der Auftrag wurde geändert. Beispielsweise wird ein Eigenschaftswert geändert, der Status des Auftrags geändert oder der Fortschritt beim Übertragen der Dateien vorgenommen. Dieses Flag wird in Befehlszeilenrückrufen ignoriert, wenn die Befehlszeilenbenachrichtigung angegeben ist.
BG_NOTIFY_FILE_TRANSFERRED
0x0010
Eine Datei im Auftrag wurde übertragen. Dieses Flag wird in Befehlszeilenrückrufen ignoriert, wenn die Befehlszeilenbenachrichtigung angegeben ist.
BG_NOTIFY_FILE_RANGES_TRANSFERRED
0x0020
Ein Bytebereich in der Datei wurde übertragen. Dieses Flag wird in Befehlszeilenrückrufen ignoriert, wenn die Befehlszeilenbenachrichtigung angegeben ist. Das Kennzeichen kann für jeden Auftrag angegeben werden, Sie erhalten jedoch nur Benachrichtigungen für Aufträge, die die Anforderungen für einen BITS_JOB_PROPERTY_ON_DEMAND_MODE Auftrag erfüllen.

Rückgabewert

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

Rückgabecode Description
S_OK
Der Typ der Ereignisbenachrichtigung wurde erfolgreich festgelegt.
E_NOTIMPL
Der NotifyFlags-Wert ist ungültig.
BG_E_INVALID_STATE
Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED werden.

Bemerkungen

Verwenden Sie die SetNotifyFlags-Methode in Verbindung mit den Methoden "IBackgroundCopyJob::SetNotifyInterface " und "IBackgroundCopyJob2::SetNotifyCmdLine ", um Ereignisbenachrichtigungen zu empfangen.

Examples

Sehen Sie sich den Beispielcode für die IBackgroundCopyJob::SetNotifyInterface-Methode an.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP
Mindestanforderungen für unterstützte Server Windows Server 2003
Zielplattform Fenster
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

Siehe auch

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface