Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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) |