IFileOperation::DeleteItems method (shobjidl_core.h)

Article
02/22/2024

Declares a set of items that are to be deleted.

Syntax

HRESULT DeleteItems(
  [in] IUnknown *punkItems
);

Parameters

[in] punkItems

Type: IUnknown*

Pointer to the IUnknown of the IShellItemArray, IDataObject, or IEnumShellItems object which represents the group of items to be deleted. You can also point to an IPersistIDList object to represent a single item, effectively accomplishing the same function as IFileOperation::DeleteItem.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method does not delete the items, it merely declares the items to be deleted. To delete a group of items, you must make at least the sequence of calls detailed here:

Call IFileOperation::DeleteItems to declare the files or folders to be deleted.
Call IFileOperation::PerformOperations to begin the delete operation.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)