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

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header bits3_0.h (include Bits.h)

See Also

Administering the Peer Cache

Peer Caching