Edit

Share via

IFileOperationProgressSink::PostMoveItem method (shobjidl_core.h)

  • Article

Performs caller-implemented actions after the move process for each item is complete.

Syntax

HRESULT PostMoveItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName,
  [in] HRESULT    hrMove,
  [in] IShellItem *psiNewlyCreated
);

Parameters

[in] dwFlags

Type: DWORD

bitwise value that contains flags that were used during the move operation. Some values can be set or changed during the move operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.

[in] psiItem

Type: IShellItem*

Pointer to an IShellItem that specifies the source item.

[in] psiDestinationFolder

Type: IShellItem*

Pointer to an IShellItem that specifies the destination folder that contains the moved item.

[in] pszNewName

Type: LPCWSTR

Pointer to the name that was given to the item after it was moved. This is a null-terminated Unicode string. Note that this might not be the name that you asked for, given collisions and other naming rules.

[in] hrMove

Type: HRESULT

The return value of the move operation. Note that this is not the HRESULT returned by MoveItem, which simply queues the move operation. Instead, this is the result of the actual move.

[in] psiNewlyCreated

Type: IShellItem*

Pointer to an IShellItem that represents the moved item in its new location.

Return value

Type: HRESULT

Returns S_OK if successful, or an error value otherwise. In the case of an error value, all subsequent operations pending from the call to IFileOperation are canceled.

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)