Share via


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: long

    Qualifiers: [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.

See Also

Concepts

CacheInfo Class