Método IBackgroundCopyCallback::JobError
A Otimização de Entrega chama a implementação do método JobError quando o estado do trabalho é alterado para BG_JOB_STATE_ERROR.
Sintaxe
HRESULT JobError(
[in] IBackgroundCopyJob *pJob,
[in] IBackgroundCopyError *pError
);
Parâmetros
-
pJob [in]
-
Contém informações relacionadas ao trabalho, como o número de bytes e arquivos transferidos antes da ocorrência do erro. Ele também contém os métodos para retomar e cancelar o trabalho. Não liberar pJob; A Otimização de Entrega libera a interface quando o método JobError retorna.
-
pError [in]
-
Contém informações de erro, como o arquivo que está sendo processado no momento em que o erro fatal ocorreu e uma descrição do erro. Não liberar pError; A Otimização de Entrega libera a interface quando o método JobError retorna.
Valor retornado
Esse método deve retornar S_OK; caso contrário, a Otimização de Entrega continuará a chamar esse método até que S_OK seja retornado. Por motivos de desempenho, você deve limitar o número de vezes que retorna um valor diferente de S_OK para algumas vezes. Como alternativa ao retorno de um código de erro, considere sempre retornar S_OK e lidar com o erro internamente. O intervalo no qual esse método é chamado é arbitrário.
Comentários
Depois de determinar a causa do erro, execute uma das seguintes opções:
- Para cancelar o trabalho, chame o método IBackgroundCopyJob::Cancel .
- Para aceitar a parte do trabalho que foi transferida com êxito antes do erro ocorrer, chame o método IBackgroundCopyJob::Complete . Essa opção não se aplica a trabalhos de upload; não é possível concluir uma parte de um trabalho de upload.
- Para concluir o processamento do trabalho, corrija o problema e chame o método IBackgroundCopyJob::Resume .
Erros transitórios não geram chamadas para o método JobError .
A Otimização de Entrega retornará BG_ERROR_CONTEXT_REMOTE_FILE se o trabalho atingir um erro HTTP 403, caso contrário, BG_ERROR_CONTEXT_NONE.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 10, versão 1709 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server, versão 1709 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|
| IID |
IID_IBackgroundCopyCallback é definido como 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22 |