IFileOperationProgressSink::PreNewItem method (shobjidl_core.h)

Performs caller-implemented actions before the process to create a new item begins.

Syntax

HRESULT PreNewItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName
);

Parameters

[in] dwFlags

Type: DWORD

bitwise value that contains flags that control the operation. See TRANSFER_SOURCE_FLAGS for flag descriptions.

[in] psiDestinationFolder

Type: IShellItem*

Pointer to an IShellItem that specifies the destination folder that will contain the new item.

[in] pszNewName

Type: LPCWSTR

Pointer to the file name of the new item, for instance Newfile.txt. This is a null-terminated, Unicode string.

Return value

Type: HRESULT

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

Requirements