IOfflineFilesItemFilter::GetTimeFilter method (cscobj.h)
Provides time-value-comparison semantics to control filtering of items based on time.
Syntax
HRESULT GetTimeFilter(
[out] FILETIME *pftTime,
[out] BOOL *pbEvalTimeOfDay,
[out] OFFLINEFILES_ITEM_TIME *pTimeType,
[out] OFFLINEFILES_COMPARE *pCompare
);
Parameters
[out] pftTime
Receives a pointer to a FILETIME structure containing the UTC time value that the item is to be compared with.
[out] pbEvalTimeOfDay
Receives a Boolean value indicating whether the time-of-day part of the FILETIME value is to be considered in the item evaluation. If the flag value is TRUE, the time-of-day is considered. If the flag value is FALSE, the time-of-day information is stripped from all time values involved in the evaluation; leaving only the year, month, and day.
This can be very helpful when the granularity of filtering is a day.
[out] pTimeType
Receives an OFFLINEFILES_ITEM_TIME enumeration value that indicates which time value associated with the cache item is to be used in the evaluation.
Only one value is to be provided. This is not a mask.
[out] pCompare
Receives an OFFLINEFILES_COMPARE enumeration value that indicates the type of logical comparison to perform between the selected item time and the filter time pointed to by the pftTime parameter.
Return value
Returns S_OK if the filter supports time filtering and the time filtering information is provided.
Returns E_NOTIMPL if time filtering is not supported.
Any other error value causes the creation of the enumerator to fail.
Remarks
In these expressions, the item time is placed on the left side of the expression. For example:
match = item_time >= filter_time
This method may be implemented in any filter type (inclusion, exclusion) or filter target (file, container).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | cscobj.h |
| DLL | CscSvc.dll; CscObj.dll |