Compartilhar via

enumeração BITS_JOB_PROPERTY_ID (bits5_0.h)

  • Artigo

Define constantes que especificam a ID da propriedade para o trabalho BITS.

Essa enumeração é usada na união BITS_JOB_PROPERTY_VALUE para determinar o tipo de valor contido na união.

Syntax

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

Constantes

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
Valor: 1
A ID usada para controlar o comportamento de transferência em redes celulares e/ou semelhantes. Essa propriedade pode ser alterada enquanto uma transferência está em andamento – os novos sinalizadores de custo entrarão em vigor imediatamente.

Essa propriedade usa o campo DWORD do BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
Valor: 2
A ID usada para registrar um retorno de chamada COM por CLSID para receber notificações sobre o progresso e a conclusão de um trabalho bits. O CLSID deve se referir a uma classe associada a um servidor COM fora do processo registrado. Ele também pode ser definido como GUID_NULL para limpar um CLSID de notificação definido anteriormente.

Essa propriedade usa o campo CLsID do BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
Valor: 3
A ID para marcar um trabalho BITS como estando disposta a baixar conteúdo que não dá suporte aos requisitos HTTP normais para downloads de BITS: HEAD solicitações, o cabeçalho Comprimento do Conteúdo e o cabeçalho Content-Range. Baixar esse tipo de conteúdo é aceita, pois o BITS não pode pausar e retomar os trabalhos de download sem esse suporte. Se um trabalho com essa propriedade habilitada for interrompido por qualquer motivo, como uma perda temporária de conectividade de rede ou a reinicialização do sistema, o BITS reiniciará o download desde o início, em vez de retomar de onde parou. O BITS também não pode limitar o uso de largura de banda para downloads dinâmicos; O BITS não executará transferências sem restrições para nenhum trabalho que não tenha BG_JOB_PRIORITY_FOREGROUND atribuído, portanto, você normalmente deve definir essa prioridade sempre que usar definir um trabalho como permitindo conteúdo dinâmico.

Essa propriedade usa o campo Habilitar do BITS_JOB_PROPERTY_VALUE. Essa propriedade só tem suporte para trabalhos BG_JOB_TYPE_DOWNLOAD . Não há suporte para downloads que usam FILE_RANGES. Essa propriedade só pode ser definida antes da primeira vez que Resume é chamado em um trabalho.
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
Valor: 4
A ID para marcar um trabalho bits como não exigir garantias de confiabilidade fortes. Habilitar essa propriedade fará com que o BITS evite manter informações sobre o progresso normal do trabalho, o que o BITS normalmente faz periodicamente. No caso de um desligamento inesperado, como uma perda de energia, durante uma transferência, isso fará com que o BITS perca o progresso

e reinicie o trabalho desde o início em vez de retomar de onde parou como de costume. No entanto, ele também reduzirá o número de gravações de disco que o BITS faz ao longo do tempo de vida de um trabalho, o que pode melhorar o desempenho de trabalhos menores.

Essa propriedade também faz com que o BITS seja baixado diretamente no arquivo de destino, em vez de baixar para um arquivo temporário e mover o arquivo temporário para o destino final depois que a transferência for concluída. Isso significa que o BITS não limpo nenhum conteúdo parcialmente baixado se um trabalho for cancelado ou encontrar uma condição de erro fatal; o chamador BITS será responsável por limpar o arquivo de destino, se ele for criado. No entanto, isso também reduzirá ligeiramente a sobrecarga do disco.

Essa propriedade só é recomendada para cenários que envolvem um grande número de trabalhos pequenos (abaixo de 1 MB) e que não exigem confiabilidade para perda de energia ou outros eventos de desligamento inesperados. As economias de desempenho geralmente não são significativas para um pequeno número de empregos ou para trabalhos maiores.

Essa propriedade usa o campo Habilitar do BITS_JOB_PROPERTY_VALUE. Essa propriedade só tem suporte para trabalhos BG_JOB_TYPE_DOWNLOAD . Essa propriedade só pode ser definida antes de adicionar arquivos a um trabalho.
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
Valor: 5
A ID para marcar o número máximo de bytes que um trabalho BITS terá permissão para baixar no total. Essa propriedade destina-se a ser usada com BITS_JOB_PROPERTY_DYNAMIC_CONTENT, em que talvez você não consiga determinar o tamanho do arquivo a ser baixado antecipadamente, mas gostaria de limitar o tamanho total do download possível.

Essa propriedade usa o campo Habilitar do BITS_JOB_PROPERTY_VALUE. Essa propriedade só tem suporte para trabalhos BG_JOB_TYPE_DOWNLOAD . Essa propriedade só pode ser definida antes da primeira vez que Resume é chamado em um trabalho.
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
Valor: 7
A ID para marcar um trabalho BITS como estando disposta a incluir credenciais padrão em solicitações para servidores proxy. Habilitar essa propriedade é equivalente a definir um nível de segurança WinHTTP de WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM nas solicitações que o BITS faz em nome do usuário. O BITS do usuário recupera as credenciais armazenadas do é o mesmo que faz solicitações de rede em nome de: o BITS normalmente usará as credenciais do proprietário do trabalho, a menos que você tenha fornecido explicitamente um token auxiliar de rede, nesse caso, o BITS usará as credenciais do token auxiliar de rede.

Essa propriedade usa o campo Destino do BITS_JOB_PROPERTY_VALUE. No entanto, há suporte apenas para o destino BG_AUTH_TARGET_PROXY .
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
Valor: 9
A ID usada para controlar o tempo das notificações JobNotification e FileRangesTransferred do BITS. Habilitar essa propriedade permite que um usuário seja notificado a uma taxa diferente. Essa propriedade pode ser alterada enquanto uma transferência está em andamento; no entanto, a nova taxa pode não ser aplicada imediatamente. O valor padrão é 500 milissegundos.

Essa propriedade usa o campo DWORD do BITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_ON_DEMAND_MODE
Valor: 10
A ID usada para controlar se um trabalho está no modo Sob Demanda. Os trabalhos sob demanda permitem que o aplicativo solicite intervalos específicos para um download de arquivo em vez de baixar do início ao fim. O valor padrão é FALSE; o trabalho não é sob demanda. Os intervalos são solicitados usando o método IBackgroundCopyFile6::RequestFileRanges .

Essa propriedade usa o campo Habilitar do BITS_JOB_PROPERTY_VALUE.

Os requisitos para um trabalho de BITS_JOB_PROPERTY_ON_DEMAND_MODE é que a transferência deve ser um trabalho BG_JOB_TYPE_DOWNLOAD . O trabalho não deve ser DYNAMIC e o servidor deve ser um servidor HTTP ou HTTPS e os requisitos de servidor para suporte de intervalo devem ser atendidos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Cabeçalho bits5_0.h

Confira também