共用方式為


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

另請參閱

IBackgroundCopyCallback

IBackgroundCopyJob