Compartir a través de

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

  • Artículo

Establece marcas que determinan si los archivos del trabajo se pueden almacenar en caché y servir a elementos del mismo nivel y si el trabajo puede descargar contenido de elementos del mismo nivel.

Sintaxis

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

Parámetros

[in] Flags

Marcas que determinan si los archivos del trabajo se pueden almacenar en caché y servirse a elementos del mismo nivel y si el trabajo puede descargar contenido de elementos del mismo nivel. Se pueden establecer las marcas siguientes:

Valor Significado
BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001
 El trabajo puede descargar contenido de elementos del mismo nivel.

El trabajo no se descargará de un mismo nivel a menos que tanto el equipo cliente como el trabajo permitan al Servicio de transferencia inteligente en segundo plano (BITS) descargar archivos de un mismo nivel. Para permitir que el equipo cliente descargue archivos de un mismo nivel, establezca la directiva de grupo EnablePeerCaching o llame al método IBitsPeerCacheAdministration::SetConfigurationFlags y establezca la marca de BG_ENABLE_PEERCACHING_CLIENT.

Si existe una de las siguientes condiciones, BITS detendrá la descarga y volverá a programar el trabajo para empezar a transferir desde un servidor del mismo nivel o de origen, dependiendo del valor del trabajo y de la memoria caché:

  • Este valor de la memoria caché es TRUE y el valor del trabajo alterna entre TRUE y FALSE.
  • Este valor de la propiedad de trabajo es TRUE y el valor de la memoria caché alterna entre TRUE y FALSE.
A continuación, la descarga se reanudará desde donde se dejó antes de que BITS detenga el trabajo. BITS 4.0: Esta marca está en desuso.
BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002
 Los archivos del trabajo se pueden almacenar en caché y servirse a elementos del mismo nivel.

BITS no almacenará en caché los archivos y los atenderá a elementos del mismo nivel a menos que tanto el equipo cliente como el trabajo permitan que BITS almacene en caché y sirvan los archivos. Para permitir que BITS almacene en caché y atienda los archivos en el equipo cliente, establezca la directiva de grupo EnablePeerCaching o llame al método IBitsPeerCacheAdministration::SetConfigurationFlags y establezca la marca BG_ENABLE_PEERCACHING_SERVER. BITS 4.0: Esta marca está en desuso.
BG_JOB_DISABLE_BRANCH_CACHE
0x0004
 BITS no usará Windows BranchCache para los trabajos de transferencia. Esta configuración no afecta al uso de Windows BranchCache por aplicaciones distintas de BITS.

Valor devuelto

El método devuelve los valores siguientes.

Código devuelto Descripción
S_OK
 Correcto

Comentarios

Establecer estas marcas solo tiene significado si el almacenamiento en caché del mismo nivel se ha habilitado estableciendo la directiva de grupo EnablePeerCaching o llamando a IBitsPeerCacheAdministration::SetConfigurationFlags.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado bits3_0.h (incluya Bits.h)
Library Bits.lib

Consulte también

IBackgroundCopyJob4

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags