IBitsPeerCacheAdministration interface (bits3_0.h)

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.

 

Inheritance

The IBitsPeerCacheAdministration interface inherits from the IUnknown interface. IBitsPeerCacheAdministration also has these types of members:

Methods

The IBitsPeerCacheAdministration interface has these methods.

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

Requirement	Value
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