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 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應