指定你想接收的事件通知類型,例如工作轉移事件。
語法
HRESULT SetNotifyFlags(
[in] ULONG Val
);
參數
[in] Val
設定以下一個或多個旗標,以識別你想要接收的事件。
| 價值觀 | Meaning |
|---|---|
|
工作中的所有檔案都已轉移。 |
|
發生錯誤。 |
|
事件通知已停用。 BITS 忽略了其他旗幟。 |
|
工作已經被修改過。 例如,屬性值改變、工作狀態改變,或檔案傳輸取得進展。 若指定命令 列通知 ,則在命令列回調中會忽略此旗標。 |
|
工作中的一個檔案已經轉移了。 若指定命令 列通知 ,則在命令列回調中會忽略此旗標。 |
|
檔案中已傳輸一段位元組。 若指定命令 列通知 ,則在命令列回調中會忽略此旗標。 這個旗標可以指定給任何職缺,但你只會收到符合 BITS_JOB_PROPERTY_ON_DEMAND_MODE 職缺要求的通知。 |
返回值
此方法回傳以下 HRESULT 值及其他值。
| 回傳碼 | Description |
|---|---|
|
事件類型通知已成功設定。 |
|
NotifyFlags 的值無效。 |
|
工作狀態無法BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED。 |
備註
使用 SetNotifyFlags 方法搭配 IBackgroundCopyJob::SetNotifyInterface 及 IBackgroundCopyJob2::SetNotifyCmdLine 方法來接收事件通知。
範例
請參閱 IBackgroundCopyJob::SetNotifyInterface 方法的範例程式碼。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | 視窗XP |
| 支援的最低伺服器 | Windows Server 2003 |
| 目標平臺 | 窗戶 |
| Header | Bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |
另請參閱
IBackgroundCopyJob2::SetNotifyCmdLine