Метод IBackgroundCopyCallback1::OnStatus (qmgr.h)

Статья
03/05/2024

[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 скачать группу после возникновения ошибки. Допустимо, только если установлен флаг dwStatus QM_STATUS_GROUP_ERROR.

[in] dwWin32Result

Код ошибки Win32. Допустимо, только если установлен флаг dwStatus QM_STATUS_GROUP_ERROR.

[in] dwTransportResult

Код ошибки HTTP. Допустимо, только если установлен флаг dwStatus QM_STATUS_GROUP_ERROR.

Возвращаемое значение

Этот метод должен возвращать S_OK; В противном случае служба продолжает вызывать этот метод, пока не будет возвращена S_OK. Интервал вызова реализации является произвольным.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Минимальная версия сервера	Windows Server 2003
Целевая платформа	Windows
Header	qmgr.h

См. также раздел

IBackgroundCopyCallback1

Поделиться через