Provides flags to control flag-based filtering of items.
Note On Windows Server operating systems beginning with Windows Server 2008 R2, the Offline Files COM API and WMI provider are available only if the Desktop Experience feature is installed.
- pullFlags [out]
Receives the Offline Files Filter Flags bit values to be used in the filter evaluation.
A bit value of 1 means that the corresponding data condition in the item must be TRUE for a filter match. A bit value of 0 means the corresponding data condition in the item must be FALSE for a filter match.
- pullMask [out]
Receives the Offline Files Filter Flags bit values identifying which flags are to be evaluated.
A bit value of 1 means "evaluate the corresponding data" while a bit value of 0 means "do not evaluate the corresponding data."
Returns S_OK if the filter supports flag filtering and the flag filtering information is provided.
Returns E_NOTIMPL if flag filtering is not supported.
Any other error value causes the creation of the enumerator to fail.
The combination of bit value and bit mask produces a relatively flexible mechanism for including and excluding items from enumeration. For example, if the OFFLINEFILES_ITEM_FILTER_FLAG_DIRECTORY flag is set in both the pullFlags and pullMask parameters, the matching item must be a directory. If the OFFLINEFILES_ITEM_FILTER_FLAG_DIRECTORY flag is set in the pullMask parameter but is not set in the pullFlags parameter, the matching item must not be a directory.
This method can be implemented in any filter type (inclusion or exclusion) or filter target (file or container).
Minimum supported client
|Windows Vista [desktop apps only]|
Minimum supported server
|Windows Server 2008 [desktop apps only]|
Build date: 10/15/2013