IBitsPeerCacheAdministration interface

Use IBitsPeerCacheAdministration to manage the pool of peers from which you can download content.

To get this interface, call the IBackgroundCopyManager::QueryInterface method, using __uuidof(IBitsPeerCacheAdministration) as the interface identifier.

Note  This interface is deprecated in BITS 4.0, and all of the API methods will return S_FALSE.
 

Methods

The IBitsPeerCacheAdministration interface has these methods.

Method Description
IBitsPeerCacheAdministration::ClearPeers Removes all peers from the list of peers that can serve content.
IBitsPeerCacheAdministration::ClearRecords Removes all the records and files from the cache.
IBitsPeerCacheAdministration::DeleteRecord Deletes a record and file from the cache. This method uses the record's identifier to identify the record to delete.
IBitsPeerCacheAdministration::DeleteUrl Deletes all cache records and the file from the cache for the given URL.
IBitsPeerCacheAdministration::DiscoverPeers Generates a list of peers that can serve content.
IBitsPeerCacheAdministration::EnumPeers Gets an IEnumBitsPeers interface pointer that you use to enumerate the peers that can serve content. The enumeration is a snapshot of the records in the cache.
IBitsPeerCacheAdministration::EnumRecords Gets an IEnumBitsPeerCacheRecords interface pointer that you use to enumerate the records in the cache. The enumeration is a snapshot of the records in the cache.
IBitsPeerCacheAdministration::GetConfigurationFlags Gets the configuration flags that determine if the computer serves content to peers and can download content from peers.
IBitsPeerCacheAdministration::GetMaximumCacheSize Gets the maximum size of the cache.
IBitsPeerCacheAdministration::GetMaximumContentAge Gets the age by when files are removed from the cache.
IBitsPeerCacheAdministration::GetRecord Gets a record from the cache.
IBitsPeerCacheAdministration::SetConfigurationFlags Sets the configuration flags that determine if the computer can serve content to peers and can download content from peers.
IBitsPeerCacheAdministration::SetMaximumCacheSize Specifies the maximum size of the cache.
IBitsPeerCacheAdministration::SetMaximumContentAge Specifies when files are removed from the cache based on age.

Remarks

You should never have to manage the peer cache; BITS manages the cache for you.

You must have administrator privileges to modify the cache.

Requirements

   
Windows version Windows Vista Windows Server 2008
Target Platform Windows
Header bits3_0.h (include Bits.h)

See Also

Administering the Peer Cache

Peer Caching