Compartir a través de

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

  • Artículo

Establece las marcas de configuración que determinan si el equipo puede servir contenido a elementos del mismo nivel y puede descargar contenido de elementos del mismo nivel.

Sintaxis

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

Parámetros

[in] Flags

Marcas que determinan si el equipo puede servir contenido a elementos del mismo nivel y pueden descargar contenido de elementos del mismo nivel. Se pueden establecer las marcas siguientes:

Valor Significado
BG_ENABLE_PEERCACHING_CLIENT
0x0001
 El equipo puede descargar contenido de elementos del mismo nivel.

BITS no descargará archivos de un mismo nivel a menos que tanto el equipo cliente como el trabajo permitan a BITS descargar archivos de un mismo nivel. Para permitir que el trabajo descargue archivos de un mismo nivel, llame al método IBackgroundCopyJob4::SetPeerCachingFlags y establezca la marca BG_JOB_ENABLE_PEERCACHING_CLIENT.

Tenga en cuenta que cambiar este valor puede afectar a todos los trabajos del equipo. Si existe una de las siguientes condiciones, BITS detendrá la descarga y volverá a programar el trabajo para empezar a transferirse desde un servidor del mismo nivel o de origen, según el valor del trabajo y la memoria caché:

  • Este valor de la memoria caché es TRUE y el valor del trabajo alterna entre TRUE y FALSE.
  • Este valor para 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.
BG_ENABLE_PEERCACHING_SERVER
0x0002
 El equipo puede servir contenido a elementos del mismo nivel.

BITS no almacenará en caché los archivos y los servirá a los elementos del mismo nivel a menos que el equipo cliente y el trabajo permitan a BITS almacenar en caché y servir archivos. Para permitir que el trabajo almacene en caché los archivos de un trabajo, llame al método IBackgroundCopyJob4::SetPeerCachingFlags y establezca la marca BG_JOB_ENABLE_PEERCACHING_SERVER.

Valor devuelto

El método devuelve los siguientes valores devueltos.

Código devuelto Descripción
S_OK
 Correcto
BG_S_OVERRIDDEN_BY_POLICY
 La preferencia de configuración se ha guardado correctamente, pero la preferencia no se usará porque un valor de directiva de grupo configurado invalida la preferencia.

El método devuelve este valor si el valor establecido es diferente del valor de la directiva de grupo. Si los valores son los mismos, el método devuelve S_OK.

Comentarios

Este valor solo se usa si no se establece la directiva de grupo EnablePeerCaching.

Un trabajo determina si descarga contenido de un elemento del mismo nivel o sirve su contenido a elementos del mismo nivel. Para obtener más información, consulte el método IBackgroundCopyJob4::SetPeerCachingFlags .

Requisitos

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

Consulte también

IBackgroundCopyJob4::SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetConfigurationFlags