IBackgroundCopyCallback1 接口 (qmgr.h)

[IBackgroundCopyCallback1 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 BITS 接口。]

实现 IBackgroundCopyCallback1 接口,以在事件发生时接收通知。 应用程序使用此接口作为轮询组状态的选项。

若要接收通知,请调用 IBackgroundCopyGroup::SetProp 方法来设置 GROUPPROP_NOTIFYCLSIDGROUPPROP_NOTIFYFLAGS 属性。

QMGR 在接口指针有效时使用接口指针, (应用程序退出) 时接口指针变为无效。 重新启动应用程序时,必须在 QMGR 仍在处理的组上重置 GROUPPROP_NOTIFYCLSID 属性。

注意 QMGR 在客户端进程范围内激活新对象;通知不会在其自己的进程中运行。 QMGR 创建该 CLSID 的新对象,并将接口指针传递给 BITS。
 
必须实现 IBackgroundCopyCallback1 接口的所有方法。 该方法至少必须返回 S_OK。 若要降低回调阻止 BITS 的可能性,请将实现保持简短。

如果管理员拥有组的所有权,则会在请求通知的用户的上下文中进行通知回调。

继承

IBackgroundCopyCallback1 接口继承自 IUnknown 接口。 IBackgroundCopyCallback1 还具有以下类型的成员:

方法

IBackgroundCopyCallback1 接口包含以下方法。

 
IBackgroundCopyCallback1::OnStatus

实现 OnStatus 方法,以在组完成或发生错误时接收通知。

要求

   
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 qmgr.h