IBackgroundCopyCallback::JobModification 方法 (bits.h)
BITS 會在修改作業時呼叫 JobModification 方法的實作。 當傳輸位元組、檔案已新增至作業、屬性已修改,或作業的狀態已變更時,服務會產生此事件。
語法
HRESULT JobModification(
[in] IBackgroundCopyJob *pJob,
[in] DWORD dwReserved
);
參數
[in] pJob
包含用來存取作業屬性、進度和狀態資訊的方法。 不要發行 pJob;BITS 會在 JobModification 方法傳回時釋放介面。
[in] dwReserved
保留供未來使用。
傳回值
這個方法應該 會傳回S_OK。
備註
您的實作可能不會在資源負載上限下收到所有修改事件。
BITS 會產生大量修改事件;請考慮建立定時器並輪詢狀態和進度資訊,或限制您使用此回呼。 如果您使用此回呼,請讓實作保持簡短。
當作業的狀態變更為BG_JOB_STATE_ERROR或BG_JOB_STATE_TRANSFERRED時,BITS 不會產生修改事件。
注意 BITS 支援每個使用者最多四個同時通知。 如果一或多個應用程式封鎖用戶傳回所有四個通知,則執行為相同使用者的應用程式將不會收到通知,直到一或多個封鎖通知傳回為止。
範例
請參閱 IBackgroundCopyCallback 介面的範例程序代碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP |
最低支援的伺服器 | Windows Server 2003 |
目標平台 | Windows |
標頭 | bits.h |