IBackgroundCopyJob：：SetNotifyFlags 方法 (bits.h)

指定您想要接收的事件通知類型，例如作業傳輸的事件。

語法

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

[in] Val

設定下列一或多個旗標，以識別您想要接收的事件。

值	意義
BG_NOTIFY_JOB_TRANSFERRED 0x0001	作業中的所有檔案都已傳輸。
BG_NOTIFY_JOB_ERROR 0x0002	發生錯誤了。
BG_NOTIFY_DISABLE 0x0004	事件通知已停用。 BITS 會忽略其他旗標。
BG_NOTIFY_JOB_MODIFICATION 0x0008	作業已修改。例如，屬性值已變更、作業的狀態已變更，或正在傳輸檔案的進度。如果指定命令行通知，則會在命令行回呼中忽略此旗標。
BG_NOTIFY_FILE_TRANSFERRED 0x0010	作業中的檔案已傳輸。如果指定命令行通知，則會在命令行回呼中忽略此旗標。
BG_NOTIFY_FILE_RANGES_TRANSFERRED 0x0020	檔案中的位元組範圍已傳輸。如果指定命令行通知，則會在命令行回呼中忽略此旗標。您可以針對任何作業指定旗標，但您只會收到符合 BITS_JOB_PROPERTY_ON_DEMAND_MODE 作業需求的作業通知。

這個方法會傳回下列 HRESULT 值，以及其他值。

傳回碼	Description
S_OK	已成功設定事件通知的類型。
E_NOTIMPL	NotifyFlags 值無效。
BG_E_INVALID_STATE	作業的狀態不能BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED。