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

Artigo
03/01/2024

[IBackgroundCopyCallback1 está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use as interfaces BITS.]

Implemente o método OnStatus para receber notificação quando o grupo for concluído ou ocorrer um erro.

Sintaxe

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

Ponteiro de interface para o grupo que gerou o evento.

[in] pJob

Ponteiro de interface para o trabalho associado ao evento ou NULL se o evento não estiver associado a um trabalho.

[in] dwFileIndex

Índice para o arquivo associado ao erro ou -1. Para recuperar o arquivo, chame o método IBackgroundCopyJob1::GetFile .

[in] dwStatus

O estado do grupo. O estado do grupo está concluído (todos os trabalhos no grupo foram baixados) ou por erro. Ocorreu um erro se o sinalizador QM_STATUS_GROUP_ERROR estiver definido. Caso contrário, o grupo será concluído.

[in] dwNumOfRetries

Número de vezes que o QMGR tentou baixar o grupo após ocorrer um erro. Válido somente se o sinalizador QM_STATUS_GROUP_ERROR dwStatus estiver definido.

[in] dwWin32Result

Código de erro win32. Válido somente se o sinalizador QM_STATUS_GROUP_ERROR dwStatus estiver definido.

[in] dwTransportResult

Código de erro HTTP. Válido somente se o sinalizador QM_STATUS_GROUP_ERROR dwStatus estiver definido.

Retornar valor

Esse método deve retornar S_OK; caso contrário, o serviço continuará a chamar esse método até que S_OK seja retornado. O intervalo no qual a implementação é chamada é arbitrário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Servidor mínimo com suporte	Windows Server 2003
Plataforma de Destino	Windows
Cabeçalho	qmgr.h

Confira também

IBackgroundCopyCallback1

Compartilhar via