IBackgroundCopyJob::SetNotifyInterface 方法

标识到传递优化的 IBackgroundCopyCallback 接口的实现。 使用 IBackgroundCopyCallback 接口接收作业相关事件的通知。

语法

HRESULT SetNotifyInterface(
   IUnknown *pNotifyInterface
);

参数

pNotifyInterface

IBackgroundCopyCallback 接口指针。 若要删除当前回调接口指针,请将此参数设置为 NULL

返回值

此方法返回以下 HRESULT 值以及其他值。

返回代码 说明
S_OK
已成功设置通知接口指针。

备注

仅当实现 IBackgroundCopyCallback 接口时,才调用此方法。 将 SetNotifyInterface 方法与 SetNotifyFlags 方法结合使用,以指定要接收的通知类型。

应用程序终止时,通知接口将变为无效;传递优化不会保留通知接口。 因此,应用程序的初始化过程应在要接收通知的现有作业上调用 SetNotifyInterface 方法。 如果需要捕获自上次运行应用程序以来发生的状态和进度信息,请在应用程序初始化期间轮询状态和进度信息。

只有作业所有者/创建者或管理员可以注册通知。

要求

要求
最低受支持的客户端
Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器
Windows Server 版本 1709 [仅限桌面应用]
标头
Deliveryoptimization.h
IDL
DeliveryOptimization.idl

Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob定义为 37668D37-507E-4160-9316-26306D150B12

另请参阅

IBackgroundCopyJob

IBackgroundCopyCallback

IBackgroundCopyJob::GetNotifyInterface

IBackgroundCopyJob::SetNotifyFlags