ICacheInfo::MaxCacheDuration Property
Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2
ICacheInfo::MaxCacheDuration is a read-only property, in Configuration Manager, that indicates the length of time that a referenced item is allowed to persist in the cache before it can be considered eligible for deletion.
[IDL]
HRESULT MaxCacheDuration([out, retval] long* pVal);
Parameters
pVal
Data type: longQualifiers: [out, retval]
Pointer to the length of time, in minutes.
Return Values
The property returns an HRESULT code. Possible values include, but are not limited to, the following:
- S_OK
The method succeeded.
Remarks
An item is referenced if it has an active ExecutionRequest.
The TombStoneDuration and MaxCacheDuration properties of the CacheElement Class object are used to manage cache item deletion. If the client does not have enough cache space for a new item then eligible unreferenced items are deleted.
An unreferenced item is eligible for deletion if the time specified in its ICacheElement::LastReferenceTime property is longer than the time specified in ICacheElement::TombStoneDuration. Deletion of eligible unreferenced cache items continues until enough space is made available in the cache for the new item.
If cache space is still required after every eligible unreferenced item has been deleted then eligible referenced items are deleted. A referenced item is eligible for deletion if the time specified in its ICacheInfo::LastReferenceTime property is longer than the time specified ICacheInfo::MaxCacheDuration. Deletion of eligible referenced cache items continues until enough space is made available in the cache for the new item.
Requirements
UIResource.dll.
Runtime Requirements
For more information, see Configuration Manager Client Runtime Requirements.
Development Requirements
For more information, see Configuration Manager Client Development Requirements.