IFileOperationProgressSink::PreNewItem method (shobjidl_core.h)

Article
02/22/2024

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

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)

Share via