ITransferAdviseSink::ConfirmOverwrite method (shobjidl_core.h)

Displays a message to the user confirming that overwriting existing items is acceptable.

Syntax

HRESULT ConfirmOverwrite(
  IShellItem *psiSource,
  IShellItem *psiDestParent,
  LPCWSTR    pszName
);

Parameters

psiSource

Type: IShellItem*

A pointer to the source IShellItem .

psiDestParent

Type: IShellItem*

A pointer to the destination parent folder IShellItem.

pszName

Type: LPCWSTR

A pointer to a wide-string containing the desired name of the item at the destination. If NULL, the name is the same as the Shell item pointed to by psiSource.

Return value

Type: HRESULT

The return values listed below are emitted specifically by this method to inform the calling process of how the operation ended. If other results or errors are emitted during the operation of this method, they should be returned to the calling process.

Return code Description
COPYENGINE_S_USER_IGNORED
The user clicked Ignore. Allows the calling process to continue processing other files as appropriate.
COPYENGINE_E_USER_CANCELLED
The user clicked Cancel. Stops processing of the current document and ends the current process.

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)