Metodo IBackgroundCopyJob4::SetPeerCachingFlags (bits3_0.h)

Articolo
02/26/2024

Imposta i flag che determinano se i file del processo possono essere memorizzato nella cache e forniti a colleghi e se il processo è possibile scaricare contenuto da peer.

Sintassi

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

Parametri

[in] Flags

Flag che determinano se i file del processo possono essere memorizzati nella cache e serviti ai peer e se il processo può scaricare il contenuto dai peer. È possibile impostare i flag seguenti:

Valore	Significato
BG_JOB_ENABLE_PEERCACHING_CLIENT 0x0001	Il processo può scaricare il contenuto dai peer. Il processo non verrà scaricato da un peer, a meno che il computer client e il processo consentano al servizio trasferimento intelligente in background (BITS) di scaricare i file da un peer. Per consentire al computer client di scaricare i file da un peer, impostare i criteri di gruppo EnablePeerCaching o chiamare il metodo IBitsPeerCacheAdministration::SetConfigurationFlags e impostare il flag BG_ENABLE_PEERCACHING_CLIENT. Se esiste una delle condizioni seguenti, BITS arresterà il download e riprogrammerà il processo per iniziare il trasferimento da un peer o dal server di origine, a seconda del valore del processo e della cache: Questo valore per la cache è TRUE e il valore per il processo passa da TRUE a FALSE. Questo valore per la proprietà del processo è TRUE e il valore della cache passa da TRUE a FALSE. Il download riprenderà quindi da dove è stato interrotto prima che BITS arresti il processo. BITS 4.0: Questo flag è deprecato.
BG_JOB_ENABLE_PEERCACHING_SERVER 0x0002	I file del processo possono essere memorizzati nella cache e serviti ai peer. BITS non memorizza nella cache i file e li serve ai peer, a meno che il computer client e il processo consentano a BITS di memorizzare nella cache e gestire i file. Per consentire a BITS di memorizzare nella cache e gestire i file nel computer client, impostare i criteri di gruppo EnablePeerCaching o chiamare il metodo IBitsPeerCacheAdministration::SetConfigurationFlags e impostare il flag BG_ENABLE_PEERCACHING_SERVER. BITS 4.0: Questo flag è deprecato.
BG_JOB_DISABLE_BRANCH_CACHE 0x0004	BITS non userà Windows BranchCache per i processi di trasferimento. Questa impostazione non influisce sull'uso di Windows BranchCache da parte di applicazioni diverse da BITS.

Valore

Significato

BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001

Il processo può scaricare il contenuto dai peer.

Il processo non verrà scaricato da un peer, a meno che il computer client e il processo consentano al servizio trasferimento intelligente in background (BITS) di scaricare i file da un peer. Per consentire al computer client di scaricare i file da un peer, impostare i criteri di gruppo EnablePeerCaching o chiamare il metodo IBitsPeerCacheAdministration::SetConfigurationFlags e impostare il flag BG_ENABLE_PEERCACHING_CLIENT.

Se esiste una delle condizioni seguenti, BITS arresterà il download e riprogrammerà il processo per iniziare il trasferimento da un peer o dal server di origine, a seconda del valore del processo e della cache:

Questo valore per la cache è TRUE e il valore per il processo passa da TRUE a FALSE.
Questo valore per la proprietà del processo è TRUE e il valore della cache passa da TRUE a FALSE.

Il download riprenderà quindi da dove è stato interrotto prima che BITS arresti il processo. BITS 4.0: Questo flag è deprecato.

BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002

I file del processo possono essere memorizzati nella cache e serviti ai peer.

BITS non memorizza nella cache i file e li serve ai peer, a meno che il computer client e il processo consentano a BITS di memorizzare nella cache e gestire i file. Per consentire a BITS di memorizzare nella cache e gestire i file nel computer client, impostare i criteri di gruppo EnablePeerCaching o chiamare il metodo IBitsPeerCacheAdministration::SetConfigurationFlags e impostare il flag BG_ENABLE_PEERCACHING_SERVER. BITS 4.0: Questo flag è deprecato.

BG_JOB_DISABLE_BRANCH_CACHE
0x0004

BITS non userà Windows BranchCache per i processi di trasferimento. Questa impostazione non influisce sull'uso di Windows BranchCache da parte di applicazioni diverse da BITS.

Valore restituito

Il metodo restituisce i valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione riuscita

Commenti

L'impostazione di questi flag ha un significato solo se la memorizzazione nella cache peer è stata abilitata impostando i criteri di gruppo EnablePeerCaching o chiamando IBitsPeerCacheAdministration::SetConfigurationFlags.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	bits3_0.h (include Bits.h)
Libreria	Bits.lib

Vedi anche

IBackgroundCopyJob4

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags

Condividi tramite