指定要接收的事件通知的类型,例如作业传输的事件。
Syntax
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 | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP |
| 支持的最低服务器 | Windows Server 2003 |
| 目标平台 | Windows操作系统 |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |
另请参阅
IBackgroundCopyJob2::SetNotifyCmdLine