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 值以及其他值。

返回代码 说明
S_OK
已成功设置事件通知的类型。
E_NOTIMPL
NotifyFlags 值无效。
BG_E_INVALID_STATE
作业的状态不能BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED。

注解

SetNotifyFlags 方法与 IBackgroundCopyJob::SetNotifyInterfaceIBackgroundCopyJob2::SetNotifyCmdLine 方法结合使用来接收事件通知。

示例

请参阅 IBackgroundCopyJob::SetNotifyInterface 方法的示例代码。

要求

要求
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface