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
);

[in] psi

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.

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.

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)