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

Se llama cuando se produce un error y se necesita la interacción del usuario.

Sintaxis

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

Parámetros

[in] psi

Tipo: IShellItem*

IShellItem en el que se produjo un error en la operación.

[in] pszItem

Tipo: LPCWSTR

Opcional. Puntero a un búfer terminado en null que contiene el nombre del archivo. Si este valor es NULL, se usa el nombre proporcionado por el parámetro psi .

[in] hrError

Tipo: HRESULT

Código de error generado por el error. El motor de copia debe controlar este error.

[in, out] pszRename

Tipo: LPWSTR

Opcional. Cuando este método vuelve, contiene un puntero a un búfer terminado en null que contiene un nuevo nombre para el archivo. El nombre no puede superar la longitud cchRename. Si este parámetro es NULL, no estará disponible ninguna opción para cambiar el nombre.

[in] cchRename

Tipo: ULONG

Tamaño del búfer pszRename , en caracteres.

Valor devuelto

Tipo: HRESULT

Cualquier otro VALOR HRESULT debe devolverse al proceso de llamada. Si el error no se controla, el valor devuelto debe ser hrError.

Código devuelto	Descripción
COPYENGINE_S_USER_RETRY	El usuario ha clic en Reintentar. El controlador debe reintentar la operación de archivo.
COPYENGINE_E_USERCANCELLED	El usuario ha clic en Cancelar. Se está finalizando todo el trabajo de copia. El controlador debe devolver este código al motor de copia.
COPYENGINE_S_USER_IGNORED	El usuario hizo clic en Omitir. El controlador debe omitir la creación del elemento y devolver este código al motor de copia.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)