Método IBitsPeerCacheAdministration::SetConfigurationFlags (bits3_0.h)

Define os sinalizadores de configuração que determinam se o computador pode fornecer conteúdo para pares e pode baixar conteúdo de pares.

Sintaxe

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

Parâmetros

[in] Flags

Sinalizadores que determinam se o computador pode fornecer conteúdo para pares e podem baixar conteúdo de pares. Os seguintes sinalizadores podem ser definidos:

Valor	Significado
BG_ENABLE_PEERCACHING_CLIENT 0x0001	O computador pode baixar conteúdo de pares. O BITS não baixará arquivos de um par, a menos que o computador cliente e o trabalho permitam que o BITS baixe arquivos de um par. Para permitir que o trabalho baixe arquivos de um par, chame o método IBackgroundCopyJob4::SetPeerCachingFlags e defina o sinalizador BG_JOB_ENABLE_PEERCACHING_CLIENT. Observe que alterar esse valor pode afetar todos os trabalhos no computador. 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 do cache alterna entre TRUE e FALSE. Em seguida, o download será retomado de onde parou antes que o BITS interrompesse o trabalho.
BG_ENABLE_PEERCACHING_SERVER 0x0002	O computador pode fornecer conteúdo para pares. O BITS não armazenará em cache os arquivos e os fornecerá aos pares, a menos que o computador cliente e o trabalho permitam que o BITS armazene em cache e sirva arquivos. Para permitir que o trabalho armazene arquivos em cache para um trabalho, chame o método IBackgroundCopyJob4::SetPeerCachingFlags e defina o sinalizador BG_JOB_ENABLE_PEERCACHING_SERVER.

Retornar valor

O método retorna os seguintes valores retornados.

Código de retorno	Descrição
S_OK	Êxito
BG_S_OVERRIDDEN_BY_POLICY	A preferência de configuração foi salva com êxito, mas a preferência não será usada porque uma configuração de Política de Grupo configurada substitui a preferência. O método retornará esse valor se o valor definido for diferente do valor da política de grupo. Se os valores forem os mesmos, o método retornará S_OK.

Comentários

Esse valor será usado somente se a política de grupo EnablePeerCaching não estiver definida.

Um trabalho determina se ele baixa conteúdo de um par ou serve seu conteúdo para pares. Para obter detalhes, consulte o método IBackgroundCopyJob4::SetPeerCachingFlags .

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::SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetConfigurationFlags