IBackgroundCopyJob::SetNotifyInterface 方法
标识到传递优化的 IBackgroundCopyCallback 接口的实现。 使用 IBackgroundCopyCallback 接口接收作业相关事件的通知。
语法
HRESULT SetNotifyInterface(
IUnknown *pNotifyInterface
);
参数
-
pNotifyInterface
-
IBackgroundCopyCallback 接口指针。 若要删除当前回调接口指针,请将此参数设置为 NULL。
返回值
此方法返回以下 HRESULT 值以及其他值。
返回代码 | 说明 |
---|---|
|
已成功设置通知接口指针。 |
备注
仅当实现 IBackgroundCopyCallback 接口时,才调用此方法。 将 SetNotifyInterface 方法与 SetNotifyFlags 方法结合使用,以指定要接收的通知类型。
应用程序终止时,通知接口将变为无效;传递优化不会保留通知接口。 因此,应用程序的初始化过程应在要接收通知的现有作业上调用 SetNotifyInterface 方法。 如果需要捕获自上次运行应用程序以来发生的状态和进度信息,请在应用程序初始化期间轮询状态和进度信息。
只有作业所有者/创建者或管理员可以注册通知。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 10版本 1709 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 版本 1709 [仅限桌面应用] |
标头 |
|
IDL |
|
库 |
|
DLL |
|
IID |
IID_IBackgroundCopyJob定义为 37668D37-507E-4160-9316-26306D150B12 |