通过

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。 调用实现的间隔是任意的。

要求

要求 值
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 qmgr.h

另请参阅

IBackgroundCopyCallback1