| UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:cscobj.IOfflineFilesItemContainer.EnumItemsEx |
IOfflineFilesItemContainer::EnumItemsEx (cscobj.h) |
Returns an enumerator of child items for the cache item implementing this method. (IOfflineFilesItemContainer.EnumItemsEx) |
|
of\iofflinefilesitemcontainer_enumitemsex.htm |
of |
001d384f-013d-41c0-a636-40206a33508d |
12/05/2018 |
EnumItemsEx, EnumItemsEx method [Offline Files], EnumItemsEx method [Offline Files],IOfflineFilesItemContainer interface, IOfflineFilesItemContainer interface [Offline Files],EnumItemsEx method, IOfflineFilesItemContainer.EnumItemsEx, IOfflineFilesItemContainer::EnumItemsEx, OFFLINEFILES_ENUM_FLAT, OFFLINEFILES_ENUM_FLAT_FILESONLY, OFFLINEFILES_ITEM_QUERY_CONNECTIONSTATE, OFFLINEFILES_ITEM_QUERY_INCLUDETRANSPARENTCACHE, OFFLINEFILES_ITEM_QUERY_LOCALDIRTYBYTECOUNT, OFFLINEFILES_ITEM_QUERY_REMOTEDIRTYBYTECOUNT, OFFLINEFILES_ITEM_QUERY_REMOTEINFO, cscobj/IOfflineFilesItemContainer::EnumItemsEx, of.iofflinefilesitemcontainer_enumitemsex |
cscobj.h |
Windows |
Windows Vista |
Windows Server 2008 |
CscSvc.dll; CscObj.dll |
Windows |
19H1 |
|
|
|
|
|
|
Returns an enumerator of child items for the cache item implementing this method. Server, share, and directory entries in the Offline Files cache implement this method to expose the enumeration of their immediate children. However, a call to QueryInterface to query a file item for IID_IOfflineFilesItemContainer fails with E_NOINTERFACE, because file items have no children.
This method is similar to IOfflineFilesItemContainer::EnumItems, except that it allows filtering and flat enumeration.
If provided, references the filter applied to the decision to include files. This parameter is optional and can be NULL.
If provided, references the filter applied to the decision to include directories. This parameter is optional and can be NULL.
If provided, references the filter applied to the decision to exclude files. This parameter is optional and can be NULL.
If provided, references the filter applied to the decision to exclude directories. This parameter is optional and can be NULL.
Flags affecting the type of enumeration performed. The parameter may contain one or more of the following flag bits.
If this flag is set, the returned enumerator will enumerate all of the item's descendants in the offline files cache. If this flag is not set, only the item's immediate children are enumerated.
If this flag is set, only file items are returned in the enumeration. Server, share, and directory entries are not included. This flag has no effect if the OFFLINEFILES_ENUM_FLAT flag is not set.
Flags affecting the amount of query activity at the time of enumeration. The parameter can contain one or more of the following bit flags.
This flag is reserved for future use.
If this flag is set, the enumeration operation includes an extra call to the Offline Files store to obtain information about the connection state (online or offline) of the item. If this flag is not set, enumeration does not include this extra operation.
If this flag is set, the find operation includes an extra call to the Offline Files store to obtain information about the amount, in bytes, of unsynchronized ("dirty") data for the associated file in the local Offline Files cache.
This flag is reserved for future use.
Allows administrators to find items cached by any user. If this flag is set and the caller is not an administrator, the method call fails.
Enumerator of IOfflineFilesItem interface pointers.
Returns S_OK if successful, or an error value otherwise.
To begin a top-down enumeration of the entire cache, perform the following steps:
- Create an instance of CLSID_OfflineFilesCache and obtain its IOfflineFilesItemContainer interface.
- Call the EnumItemsEx method to obtain an enumerator for the server entries.
- For each entry returned, call QueryInterface for IOfflineFilesItemContainer.
- If QueryInterface succeeds, the item supports children. If so, enumerate each child, calling QueryInterface for IOfflineFilesItemContainer on each. This pattern may be recursively applied to enumerate the entire cache.
| Inclusion Match | Inclusion No Match | |
|---|---|---|
| Exclusion Match | Excluded | Excluded |
| Exclusion No Match | Included | Excluded |
As the table illustrates, if the exclusion filter matches or the inclusion filter does not match, the item is excluded from enumeration. For an item to be included in the enumeration, the exclusion filter must not match and the inclusion filter must match.