Metodo IBitsPeerCacheAdministration::SetConfigurationFlags (bits3_0.h)

Articolo
03/13/2024

Imposta i flag di configurazione che determinano se il computer può gestire il contenuto ai peer e può scaricare il contenuto da peer.

Sintassi

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

Parametri

[in] Flags

Flag che determinano se il computer può gestire il contenuto ai peer e può scaricare il contenuto dai peer. È possibile impostare i flag seguenti:

Valore	Significato
BG_ENABLE_PEERCACHING_CLIENT 0x0001	Il computer può scaricare il contenuto dai peer. BITS non scaricherà i file da un peer, a meno che il computer client e il processo consentano a BITS di scaricare i file da un peer. Per consentire al processo di scaricare file da un peer, chiamare il metodo IBackgroundCopyJob4::SetPeerCachingFlags e impostare il flag BG_JOB_ENABLE_PEERCACHING_CLIENT. Si noti che la modifica di questo valore può influire su tutti i processi nel computer. 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.
BG_ENABLE_PEERCACHING_SERVER 0x0002	Il computer può servire il contenuto 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 al processo di memorizzare nella cache i file per un processo, chiamare il metodo IBackgroundCopyJob4::SetPeerCachingFlags e impostare il flag BG_JOB_ENABLE_PEERCACHING_SERVER.

Valore

Significato

BG_ENABLE_PEERCACHING_CLIENT
0x0001

Il computer può scaricare il contenuto dai peer.

BITS non scaricherà i file da un peer, a meno che il computer client e il processo consentano a BITS di scaricare i file da un peer. Per consentire al processo di scaricare file da un peer, chiamare il metodo IBackgroundCopyJob4::SetPeerCachingFlags e impostare il flag BG_JOB_ENABLE_PEERCACHING_CLIENT.

Si noti che la modifica di questo valore può influire su tutti i processi nel computer. 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.

BG_ENABLE_PEERCACHING_SERVER
0x0002

Il computer può servire il contenuto 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 al processo di memorizzare nella cache i file per un processo, chiamare il metodo IBackgroundCopyJob4::SetPeerCachingFlags e impostare il flag BG_JOB_ENABLE_PEERCACHING_SERVER.

Valore restituito

Il metodo restituisce i valori restituiti seguenti.

Codice restituito	Descrizione
S_OK	Operazione riuscita
BG_S_OVERRIDDEN_BY_POLICY	La preferenza di configurazione è stata salvata correttamente, ma la preferenza non verrà usata perché un'impostazione di Criteri di gruppo configurata sostituisce la preferenza. Il metodo restituisce questo valore se il set di valori è diverso dal valore di Criteri di gruppo. Se i valori sono uguali, il metodo restituisce S_OK.

Commenti

Questo valore viene usato solo se i criteri di gruppo EnablePeerCaching non sono impostati.

Un processo determina se scarica il contenuto da un peer o ne serve il contenuto ai peer. Per informazioni dettagliate, vedere il metodo IBackgroundCopyJob4::SetPeerCachingFlags .

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

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetConfigurationFlags

Condividi tramite