Share via

Método IBackgroundCopyCallback1::OnStatus (qmgr.h)

  • Artículo

[IBackgroundCopyCallback1 está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use las interfaces BITS.]

Implemente el método OnStatus para recibir una notificación cuando se complete el grupo o se produzca un error.

Sintaxis

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

Parámetros

[in] pGroup

Puntero de interfaz al grupo que generó el evento.

[in] pJob

Puntero de interfaz al trabajo asociado al evento o NULL si el evento no está asociado a un trabajo.

[in] dwFileIndex

Indexe al archivo asociado al error o -1. Para recuperar el archivo, llame al método IBackgroundCopyJob1::GetFile .

[in] dwStatus

Estado del grupo. El estado del grupo es completo (se han descargado todos los trabajos del grupo) o se ha producido un error. Error si se establece la marca QM_STATUS_GROUP_ERROR. De lo contrario, el grupo está completo.

[in] dwNumOfRetries

Número de veces que QMGR intentó descargar el grupo después de producirse un error. Válido solo si se establece la marca QM_STATUS_GROUP_ERROR dwStatus .

[in] dwWin32Result

Código de error de Win32. Válido solo si se establece la marca QM_STATUS_GROUP_ERROR dwStatus .

[in] dwTransportResult

Código de error HTTP. Válido solo si se establece la marca QM_STATUS_GROUP_ERROR dwStatus .

Valor devuelto

Este método debe devolver S_OK; de lo contrario, el servicio continúa llamando a este método hasta que se devuelva S_OK. El intervalo en el que se llama a la implementación es arbitrario.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP
Servidor mínimo compatible Windows Server 2003
Plataforma de destino Windows
Encabezado qmgr.h

Consulte también

IBackgroundCopyCallback1