Compartilhar via


Método ITransferAdviseSink::SubStreamFailure (shobjidl_core.h)

Chamado quando há uma falha que envolve fluxos secundários e a interação do usuário é necessária.

Sintaxe

HRESULT SubStreamFailure(
  [in] IShellItem *psi,
  [in] LPCWSTR    pszStreamName,
  [in] HRESULT    hrError
);

Parâmetros

[in] psi

Tipo: IShellItem*

Um ponteiro para o IShellItem que causou a falha.

[in] pszStreamName

Tipo: LPCWSTR

O nome dos dados que serão perdidos na operação.

[in] hrError

Tipo: HRESULT

O código de erro que foi gerado. Ele deve ser manipulado pelo mecanismo de cópia.

Valor retornado

Tipo: HRESULT

Qualquer outro HRESULT deve ser passado para cima. Se a falha não for tratada, o valor retornado deverá ser hrError.

Código de retorno Descrição
COPYENGINE_S_USERRETRY
O manipulador deve repetir a operação de arquivo.
COPYENGINE_S_USERRETRYWITHNEWNAME
O manipulador deve repetir a operação de arquivo usando o nome retornado no buffer pszRename .
COPYENGINE_S_OVERWRITE
O usuário indicou que o manipulador deve substituir o arquivo existente.
COPYENGINE_S_RETRYWITHOUTSECURITY
O usuário indicou que o manipulador deve tentar a operação novamente sem o descritor de segurança.
COPYENGINE_E_USERCANCELLED
O usuário clicou em Cancelar. Todo o trabalho de cópia está sendo encerrado. O manipulador deve retornar esse código de volta ao mecanismo de cópia.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)