Compartilhar via


Método ITransferAdviseSink::P ropertyFailure (shobjidl_core.h)

Chamado quando há uma falha que envolve propriedades de arquivo e a interação do usuário é necessária.

Sintaxe

HRESULT PropertyFailure(
  [in] IShellItem        *psi,
  [in] const PROPERTYKEY *pkey,
  [in] HRESULT           hrError
);

Parâmetros

[in] psi

Tipo: IShellItem*

Um ponteiro para o IShellItem que causou a falha.

[in] pkey

Tipo: const PROPERTYKEY*

Um valor que corresponde à propriedade que será perdida. Um valor NULL indica que todas as propriedades foram perdidas.

[in] hrError

Tipo: HRESULT

O código de erro gerado pela falha. Ele deve ser manipulado pelo mecanismo de cópia.

Retornar valor

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

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)