Compartilhar via

Método IBackgroundCopyJob4::SetPeerCachingFlags (bits3_0.h)

  • Artigo

Define sinalizadores que determinam se os arquivos do trabalho podem ser armazenados em cache e enviados aos pares e se o trabalho pode baixar conteúdo de pares.

Sintaxe

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

Parâmetros

[in] Flags

Sinalizadores que determinam se os arquivos do trabalho podem ser armazenados em cache e servidos aos pares e se o trabalho pode baixar conteúdo de pares. Os seguintes sinalizadores podem ser definidos:

Valor Significado
BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001
 O trabalho pode baixar conteúdo de pares.

O trabalho não será baixado de um par, a menos que o computador cliente e o trabalho permitam que o BITS (Serviço de Transferência Inteligente em Segundo Plano) baixe arquivos de um par. Para permitir que o computador cliente baixe arquivos de um par, defina a política de grupo EnablePeerCaching ou chame o método IBitsPeerCacheAdministration::SetConfigurationFlags e defina o sinalizador BG_ENABLE_PEERCACHING_CLIENT.

Se houver uma das seguintes condições, o BITS interromperá o download e reagendará o trabalho para começar a transferir de um par ou do servidor de origem, dependendo do valor do trabalho e do cache:

  • Esse valor para o cache é TRUE e o valor do trabalho alterna entre TRUE e FALSE.
  • Esse valor para a propriedade de trabalho é TRUE e o valor para o cache alterna entre TRUE e FALSE.
Em seguida, o download será retomado de onde parou antes que o BITS interrompesse o trabalho. BITS 4.0: Esse sinalizador foi preterido.
BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002
 Os arquivos do trabalho podem ser armazenados em cache e servidos aos pares.

O BITS não armazenará os arquivos em cache e os servirá aos pares, a menos que o computador cliente e o trabalho permitam que o BITS armazene e sirva os arquivos. Para permitir que o BITS armazene em cache e sirva os arquivos no computador cliente, defina a política de grupo EnablePeerCaching ou chame o método IBitsPeerCacheAdministration::SetConfigurationFlags e defina o sinalizador BG_ENABLE_PEERCACHING_SERVER. BITS 4.0: Esse sinalizador foi preterido.
BG_JOB_DISABLE_BRANCH_CACHE
0x0004
 O BITS não usará o Windows BranchCache para trabalhos de transferência. Essa configuração não afeta o uso do Windows BranchCache por aplicativos diferentes de BITS.

Retornar valor

O método retorna os valores a seguir.

Código de retorno Descrição
S_OK
 Êxito

Comentários

Definir esses sinalizadores terá significado somente se o cache par tiver sido habilitado definindo a política de grupo EnablePeerCaching ou chamando IBitsPeerCacheAdministration::SetConfigurationFlags.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho bits3_0.h (inclua Bits.h)
Biblioteca Bits.lib

Confira também

IBackgroundCopyJob4

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags