BG_JOB_STATE enumeração (bits.h)

  • Artigo

Define constantes que especificam os diferentes estados de um trabalho.

Syntax

typedef enum BG_JOB_STATE {
  BG_JOB_STATE_QUEUED = 0,
  BG_JOB_STATE_CONNECTING,
  BG_JOB_STATE_TRANSFERRING,
  BG_JOB_STATE_SUSPENDED,
  BG_JOB_STATE_ERROR,
  BG_JOB_STATE_TRANSIENT_ERROR,
  BG_JOB_STATE_TRANSFERRED,
  BG_JOB_STATE_ACKNOWLEDGED,
  BG_JOB_STATE_CANCELLED
} ;

Constantes

 
BG_JOB_STATE_QUEUED
Valor: 0
Especifica que o trabalho está na fila e aguardando a execução. Se um usuário fizer logoff enquanto o trabalho estiver sendo transferido, o trabalho fará a transição para o estado enfileirado.
BG_JOB_STATE_CONNECTING
Especifica que o BITS está tentando se conectar ao servidor. Se a conexão for bem-sucedida, o estado do trabalho se tornará BG_JOB_STATE_TRANSFERRING; caso contrário, o estado se tornará BG_JOB_STATE_TRANSIENT_ERROR.
BG_JOB_STATE_TRANSFERRING
Especifica que o BITS está transferindo dados para o trabalho.
BG_JOB_STATE_SUSPENDED
Especifica que o trabalho está suspenso (pausado). Para suspender um trabalho, chame o método IBackgroundCopyJob::Suspend. O BITS suspende automaticamente um trabalho quando ele é criado. O trabalho permanece suspenso até que você chame o método IBackgroundCopyJob::Resume, o método IBackgroundCopyJob::Complete ou o método IBackgroundCopyJob::Cancel.
BG_JOB_STATE_ERROR
Especifica que ocorreu um erro não recuperável (o serviço não pode transferir o arquivo). Se o erro, como um erro de acesso negado, puder ser corrigido, chame o
Método IBackgroundCopyJob::Resume depois que o erro for corrigido. No entanto, se o erro não puder ser corrigido, chame o
Método IBackgroundCopyJob::Cancel para cancelar o trabalho ou chamar o
Método IBackgroundCopyJob::Complete para aceitar a parte de um trabalho de download que foi transferido com êxito.
BG_JOB_STATE_TRANSIENT_ERROR
Especifica que ocorreu um erro recuperável. O BITS tentará novamente os trabalhos no estado de erro transitório com base no intervalo de repetição especificado (consulte o método IBackgroundCopyJob::SetMinimumRetryDelay). O estado do trabalho será alterado para BG_JOB_STATE_ERROR se o trabalho não conseguir fazer progresso (consulte o método IBackgroundCopyJob::SetNoProgressTimeout).

O BITS não tentará novamente o trabalho se ocorrer uma desconexão de rede ou um erro de bloqueio de disco (por exemplo, chkdsk estiver em execução) ou se o Política de Grupo MaxInternetBandwidth for zero.
BG_JOB_STATE_TRANSFERRED
Especifica que seu trabalho foi processado com êxito. Você deve chamar o
Método IBackgroundCopyJob::Complete para reconhecer a conclusão do trabalho e disponibilizar os arquivos para o cliente.
BG_JOB_STATE_ACKNOWLEDGED
Especifica que você chamou o método IBackgroundCopyJob::Complete para reconhecer que seu trabalho foi concluído com êxito.
BG_JOB_STATE_CANCELLED
Especifica que você chamou o
Método IBackgroundCopyJob::Cancel para cancelar o trabalho (ou seja, para remover o trabalho da fila de transferência).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Cabeçalho bits.h

Confira também