IBackgroundCopyCallback1：：OnStatus 方法 (qmgr.h)

[IBackgroundCopyCallback1 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 請改用 BITS 介面。]

實作 OnStatus 方法，以在群組完成或發生錯誤時接收通知。

語法

HRESULT OnStatus(
  [in] IBackgroundCopyGroup *pGroup,
  [in] IBackgroundCopyJob1  *pJob,
  [in] DWORD                dwFileIndex,
  [in] DWORD                dwStatus,
  [in] DWORD                dwNumOfRetries,
  [in] DWORD                dwWin32Result,
  [in] DWORD                dwTransportResult
);

參數

[in] pGroup

產生事件的群組介面指標。

[in] pJob

與事件相關聯的作業介面指標，如果事件與作業沒有關聯，則為 NULL 。

[in] dwFileIndex

與錯誤或 -1 相關聯的檔案索引。 若要擷取檔案，請呼叫 IBackgroundCopyJob1：：GetFile 方法。

[in] dwStatus

群組的狀態。 群組的狀態已完成， (群組中的所有作業都已下載) 或發生錯誤。 如果已設定QM_STATUS_GROUP_ERROR旗標，就會發生錯誤。 否則，群組就會完成。

[in] dwNumOfRetries

發生錯誤之後，QMGR 嘗試下載群組的次數。 只有當已設定 QM_STATUS_GROUP_ERROR dwStatus 旗標時，才有效。

[in] dwWin32Result

Win32 錯誤碼。 只有當已設定 QM_STATUS_GROUP_ERROR dwStatus 旗標時，才有效。

[in] dwTransportResult

HTTP 錯誤碼。 只有當已設定 QM_STATUS_GROUP_ERROR dwStatus 旗標時，才有效。

傳回值

這個方法應該傳回 S_OK;否則，服務會繼續呼叫這個方法，直到傳回S_OK為止。 呼叫實作的間隔是任意的。

規格需求

另請參閱

IBackgroundCopyCallback1