ITransferSource::RecycleItem method
Recycle the item into the provided recycle location and return the item in its new location.
Syntax
HRESULT RecycleItem( [in] IShellItem *psiSource, [in] IShellItem *psiParentDest, [in] TRANSFER_SOURCE_FLAGS dwDeleteFlags, [out] IShellItem **ppsiNewDest );
Parameters
- psiSource [in]
-
Type: IShellItem*
A pointer to the IShellItem to be recycled.
- psiParentDest [in]
-
Type: IShellItem*
A pointer to the IShellItem of the recycle location (the new parent of the item).
- dwDeleteFlags [in]
-
Type: TRANSFER_SOURCE_FLAGS
The flags that control the file operation. One or more of the TRANSFER_SOURCE_FLAGS constants.
- ppsiNewDest [out]
-
Type: IShellItem**
When the method returns, contains the address of a pointer to the recycled IShellItem.
Return value
Type: HRESULT
Returns one of the following, or an error code.
| Return code | Description |
|---|---|
|
User responded "Yes" to the dialog. |
|
User responded to retry the current action. |
|
User responded "No" to the dialog. |
|
Children items should not be processed. |
|
Error has been queued and will display later. |
|
User canceled the current action. |
|
Operation requires elevated privileges. |
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
IDL |
|