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