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) |