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

Chamado quando há uma falha e a interação do usuário é necessária.

Sintaxe

HRESULT FileFailure(
  [in]      IShellItem *psi,
  [in]      LPCWSTR    pszItem,
  [in]      HRESULT    hrError,
  [in, out] LPWSTR     pszRename,
  [in]      ULONG      cchRename
);

Parâmetros

[in] psi

Tipo: IShellItem*

O IShellItem no qual a operação falhou.

[in] pszItem

Tipo: LPCWSTR

Opcional. Um ponteiro para um buffer encerrado em nulo que contém o nome do arquivo. Se esse valor for NULL, o nome fornecido pelo parâmetro psi será usado.

[in] hrError

Tipo: HRESULT

O código de erro gerado pela falha. Esse erro deve ser tratado pelo mecanismo de cópia.

[in, out] pszRename

Tipo: LPWSTR

Opcional. Quando esse método retorna, contém um ponteiro para um buffer encerrado em nulo que contém um novo nome para o arquivo. O nome não pode exceder o comprimento cchRename. Se esse parâmetro for NULL, nenhuma opção para renomear estará disponível.

[in] cchRename

Tipo: ULONG

O tamanho do buffer pszRename , em caracteres.

Retornar valor

Tipo: HRESULT

Qualquer outro HRESULT deve ser retornado ao processo de chamada. Se a falha não for tratada, o valor retornado deverá ser hrError.

Código de retorno	Descrição
COPYENGINE_S_USER_RETRY	O usuário clicou em Repetir. O manipulador deve repetir a operação de arquivo.
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.
COPYENGINE_S_USER_IGNORED	O usuário clicou em Ignorar. O manipulador deve ignorar a criação do item e retornar esse código de volta ao mecanismo de cópia.

Requisitos

Requisito	Valor
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)