IBackgroundCopyJob::SetNotifyFlags 方法 (bits.h)

指定要接收的事件通知的类型,例如作业传输的事件。

Syntax

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 价值
最低支持的客户端 Windows XP
支持的最低服务器 Windows Server 2003
目标平台 Windows操作系统
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface