IBackgroundCopyJob::SetNotifyFlags 方法 (bits.h)
指定要接收的事件通知的类型,例如作业传输的事件。
语法
HRESULT SetNotifyFlags(
[in] ULONG Val
);
参数
[in] Val
设置以下一个或多个标志,以标识要接收的事件。
值 | 含义 |
---|---|
|
作业中的所有文件都已传输。 |
|
出现错误。 |
|
已禁用事件通知。 BITS 忽略其他标志。 |
|
作业已修改。 例如,属性值已更改、作业状态已更改或文件传输进度。 如果指定了命令行 通知 ,则命令行回调中将忽略此标志。 |
|
作业中的文件已传输。 如果指定了命令行 通知 ,则命令行回调中将忽略此标志。 |
|
已传输文件中的字节范围。 如果指定了命令行 通知 ,则命令行回调中将忽略此标志。 可以为任何作业指定标志,但你只会收到满足 BITS_JOB_PROPERTY_ON_DEMAND_MODE 作业要求的作业的通知。 |
返回值
此方法返回以下 HRESULT 值以及其他值。
返回代码 | 说明 |
---|---|
|
已成功设置事件通知的类型。 |
|
NotifyFlags 值无效。 |
|
作业的状态不能BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED。 |
注解
将 SetNotifyFlags 方法与 IBackgroundCopyJob::SetNotifyInterface 和 IBackgroundCopyJob2::SetNotifyCmdLine 方法结合使用来接收事件通知。
示例
请参阅 IBackgroundCopyJob::SetNotifyInterface 方法的示例代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP |
最低受支持的服务器 | Windows Server 2003 |
目标平台 | Windows |
标头 | bits.h |
Library | Bits.lib |
DLL | QmgrPrxy.dll |
另请参阅
IBackgroundCopyJob2::SetNotifyCmdLine