Share via


Método IBackgroundCopyJob::GetErrorCount (bits.h)

Recupera o número de vezes que o BITS tentou transferir o trabalho e ocorreu um erro.

Sintaxe

HRESULT GetErrorCount(
  [out] ULONG *Errors
);

Parâmetros

[out] Errors

Número de erros que ocorreram enquanto o BITS tentava transferir o trabalho. A contagem aumenta quando o trabalho passa do estado BG_JOB_STATE_TRANSFERRING para o estado BG_JOB_STATE_TRANSIENT_ERROR ou BG_JOB_STATE_ERROR.

Retornar valor

Esse método retorna S_OK em caso de êxito ou um dos valores COM HRESULT padrão em caso de erro.

Comentários

A contagem nunca é redefinida. A contagem pode não refletir com precisão o número de vezes que o trabalho é movido para o estado de erro ou erro transitório. Por exemplo, o BITS não aumenta a contagem quando ocorrem desconexões de rede, o programa de disco marcar é executado ou a política de largura de banda impede a transferência de trabalhos.

O BITS também aumenta a contagem sempre que tenta transferir o trabalho quando o trabalho está no estado de erro transitório e o trabalho falha.

BITS 1.5 e anterior: O BITS não aumenta a contagem sempre que tenta transferir o trabalho quando ele está no estado de erro transitó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 bits.h
Biblioteca Bits.lib
DLL QmgrPrxy.dll

Confira também

IBackgroundCopyJob::GetError