nf-shobjidl_core-itransferadvisesink-substreamfailure.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:shobjidl_core.ITransferAdviseSink.SubStreamFailure	ITransferAdviseSink::SubStreamFailure (shobjidl_core.h)	Called when there is a failure that involves secondary streams and user interaction is needed.	ITransferAdviseSink interface [Windows Shell] SubStreamFailure method ITransferAdviseSink.SubStreamFailure ITransferAdviseSink::SubStreamFailure SubStreamFailure SubStreamFailure method [Windows Shell] SubStreamFailure method [Windows Shell] ITransferAdviseSink interface _shell_ITransferAdviseSink_SubStreamFailure shell.ITransferAdviseSink_SubStreamFailure shobjidl_core/ITransferAdviseSink::SubStreamFailure	shell\ITransferAdviseSink_SubStreamFailure.htm	shell	4cca3bc0-45c6-40ee-8050-7035faa1e601	12/05/2018	ITransferAdviseSink interface [Windows Shell],SubStreamFailure method, ITransferAdviseSink.SubStreamFailure, ITransferAdviseSink::SubStreamFailure, SubStreamFailure, SubStreamFailure method [Windows Shell], SubStreamFailure method [Windows Shell],ITransferAdviseSink interface, _shell_ITransferAdviseSink_SubStreamFailure, shell.ITransferAdviseSink_SubStreamFailure, shobjidl_core/ITransferAdviseSink::SubStreamFailure	shobjidl_core.h	Shobjidl.h	Windows	Windows Vista [desktop apps only]	Windows Server 2008 [desktop apps only]					Shobjidl.idl								Windows			19H1	ITransferAdviseSink::SubStreamFailure shobjidl_core/ITransferAdviseSink::SubStreamFailure	c++	APIRef kbSyntax	COM	shobjidl_core.h	ITransferAdviseSink.SubStreamFailure

ITransferAdviseSink::SubStreamFailure

-description

Called when there is a failure that involves secondary streams and user interaction is needed.

-parameters

-param psi [in]

Type: IShellItem*

A pointer to the IShellItem that caused the failure.

-param pszStreamName [in]

Type: LPCWSTR

The name of the data that will be lost in the operation.

-param hrError [in]

Type: HRESULT

The error code that was generated. It must be handled by the copy engine.

-returns

Type: HRESULT

Any other HRESULT should be passed up. If the failure is not handled, the return value should be hrError.

Return code	Description
COPYENGINE_S_USERRETRY	The handler should retry the file operation.
COPYENGINE_S_USERRETRYWITHNEWNAME	The handler should retry the file operation using the name returned in the pszRename buffer.
COPYENGINE_S_OVERWRITE	The user has indicated that the handler should overwrite the existing file.
COPYENGINE_S_RETRYWITHOUTSECURITY	The user has indicated that the handler should try the operation again without the security descriptor.
COPYENGINE_E_USERCANCELLED	The user clicked Cancel. The entire copy job is being terminated. The handler should return this code back to the copy engine.