ITransferAdviseSink::SubStreamFailure method
Called when there is a failure that involves secondary streams and user interaction is needed.
Syntax
HRESULT SubStreamFailure( [in] IShellItem *psi, [in] LPCWSTR pszStreamName, [in] HRESULT hrError );
Parameters
- psi [in]
-
Type: IShellItem*
A pointer to the IShellItem that caused the failure.
- pszStreamName [in]
-
Type: LPCWSTR
The name of the data that will be lost in the operation.
- hrError [in]
-
Type: HRESULT
The error code that was generated. It must be handled by the copy engine.
Return value
Type: HRESULT
Any other HRESULT should be passed up. If the failure is not handled, the return value should be hrError.
| Return code | Description |
|---|---|
|
The handler should retry the file operation. |
|
The handler should retry the file operation using the name returned in the pszRename buffer. |
|
The user has indicated that the handler should overwrite the existing file. |
|
The user has indicated that the handler should try the operation again without the security descriptor. |
|
The user clicked Cancel. The entire copy job is being terminated. The handler should return this code back to the copy engine. |
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
IDL |
|