IFileOperationProgressSink::PostCopyItem method

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

Syntax


HRESULT PostCopyItem(
  [in]         DWORD      dwFlags,
  [in]         IShellItem *psiItem,
  [in]         IShellItem *psiDestinationFolder,
  [in, unique] LPCWSTR    pszNewName,
  [in]         HRESULT    hrCopy,
  [in]         IShellItem *psiNewlyCreated
);

Parameters

dwFlags [in]

Type: DWORD

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

psiItem [in]

Type: IShellItem*

Pointer to an IShellItem that specifies the source item.

psiDestinationFolder [in]

Type: IShellItem*

Pointer to an IShellItem that specifies the destination folder to which the item was copied.

pszNewName [in]

Type: LPCWSTR

Pointer to the new name that was given to the item after it was copied. 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.

hrCopy [in]

Type: HRESULT

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

psiNewlyCreated [in]

Type: IShellItem*

Pointer to an IShellItem that represents the new copy of the item.

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

See also

IFileOperationProgressSink
IFileOperationProgressSink::PreCopyItem
CopyItem

 

 

Show: