| 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.IOfflineFilesCache.DeleteItems |
IOfflineFilesCache::DeleteItems (cscobj.h) |
Deletes files and directories from the local cache. |
|
of\iofflinefilescache_deleteitems.htm |
of |
e6326364-fbd0-4446-97c3-6a3940856efb |
12/05/2018 |
DeleteItems, DeleteItems method [Offline Files], DeleteItems method [Offline Files],IOfflineFilesCache interface, IOfflineFilesCache interface [Offline Files],DeleteItems method, IOfflineFilesCache.DeleteItems, IOfflineFilesCache::DeleteItems, OFFLINEFILES_DELETE_FLAG_ADMIN, OFFLINEFILES_DELETE_FLAG_DELMODIFIED, OFFLINEFILES_DELETE_FLAG_NOAUTOCACHED, OFFLINEFILES_DELETE_FLAG_NOPINNED, cscobj/IOfflineFilesCache::DeleteItems, of.iofflinefilescache_deleteitems |
cscobj.h |
Windows |
Windows Vista |
Windows Server 2008 |
CscSvc.dll; CscObj.dll |
Windows |
19H1 |
|
|
|
|
|
|
Deletes files and directories from the local cache. Deleting a container item implies deletion of all its contained items, recursively.
Array of pointers, each to a fully qualified UNC path of a file or directory to be deleted.
Number of paths in the rgpszPaths array.
Flags controlling the behavior of the delete operation. This parameter can be one or more of the following values.
Do not delete automatically cached items. The default behavior is to delete automatically cached items.
Do not delete pinned items. The default behavior is to delete pinned items.
Delete even if locally modified in the cache. The default behavior is to not delete files with unsynchronized local changes.
Allows administrators to enumerate and delete all files regardless of access rights. If this flag is set and the caller is not an administrator, the function fails.
Indicates if the operation is to be performed asynchronously. If this parameter is TRUE, the operation is scheduled for asynchronous operation and the function returns immediately. If this parameter is FALSE, the function returns when the operation is complete.
Interface to an event sink that will receive progress events during the operation. If events are not desired, this parameter may be NULL. Providing an event sink is highly recommended for asynchronous operation. A progress implementation is the only way to be notified when the asynchronous operation completes.
Returns S_OK if successful, or an error value otherwise.
Returns HRESULT_FROM_WIN32(ERROR_CANCELLED) if the operation is canceled.
Returns HRESULT_FROM_WIN32(ERROR_MORE_DATA) if errors occurred during the operation. Use the IOfflineFilesSimpleProgress::ItemResult callback method to detect errors as they occur.
The caller must have sufficient access to the files and directories to be deleted.
If a delete operation is canceled while in progress, changes to files processed to that point are not rolled back.
If a delete operation on a directory cannot remove all of its contained files or directories (for example, if access is denied), the specified directory entry is not removed. Any files and directories deleted up to that point remain deleted.
Files are deleted only from the local cache. Associated files on the network server are not affected.
Files deleted are not recoverable through the Recycle Bin. Files deleted must be re-cached to be available offline.
If only one path is provided in the rgpszPaths parameter and that path is to a single file, the return value indicates the result of that single delete operation. Otherwise, the caller must implement the progress callback methods in the following list and monitor the IOfflineFilesSimpleProgress::ItemResult method to obtain the result for each processed file and directory.
| Progress Events Interface | Method | Description |
|---|---|---|
| IOfflineFilesProgress | Begin | Called at the start of the operation. |
| IOfflineFilesSimpleProgress | ItemBegin | Called at the start of processing for each file. |
| IOfflineFilesSimpleProgress | ItemResult | Called after each file is deleted. |
| IOfflineFilesProgress | QueryAbort | Called periodically during the sync operation to detect a request for cancellation. |
| IOfflineFilesProgress | End | Called at the end of the operation. |