IFileOperationProgressSink::PostRenameItem method (shobjidl_core.h)

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

Syntax

HRESULT PostRenameItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [in] LPCWSTR    pszNewName,
  [in] HRESULT    hrRename,
  [in] IShellItem *psiNewlyCreated
);

Parameters

[in] dwFlags

Type: DWORD

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

[in] psiItem

Type: IShellItem*

Pointer to an IShellItem that specifies the item before it was renamed.

[in] pszNewName

Type: LPCWSTR

Pointer to the new display name of the item. 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] hrRename

Type: HRESULT

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

[in] psiNewlyCreated

Type: IShellItem*

Pointer to an IShellItem that represents the item with its new name.

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)