共用方式為


IBackgroundCopyJob::SetNotifyFlags 方法(bits.h)

指定你想接收的事件通知類型,例如工作轉移事件。

語法

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

參數

[in] Val

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

價值觀 Meaning
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。

備註

使用 SetNotifyFlags 方法搭配 IBackgroundCopyJob::SetNotifyInterfaceIBackgroundCopyJob2::SetNotifyCmdLine 方法來接收事件通知。

範例

請參閱 IBackgroundCopyJob::SetNotifyInterface 方法的範例程式碼。

需求

Requirement 價值觀
最低支援的用戶端 視窗XP
支援的最低伺服器 Windows Server 2003
目標平臺 窗戶
Header Bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另請參閱

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface