Поделиться через

Метод ITransferAdviseSink::P ropertyFailure (shobjidl_core.h)

  • Статья

Вызывается при сбое, который включает свойства файла и требуется взаимодействие с пользователем.

Синтаксис

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

Параметры

[in] psi

Тип: IShellItem*

Указатель на IShellItem , вызвавшего сбой.

[in] pkey

Тип: const PROPERTYKEY*

Значение , соответствующее свойству, которое будет потеряно. Значение NULL указывает, что все свойства были потеряны.

[in] hrError

Тип: HRESULT

Код ошибки, сгенерированный ошибкой. Он должен обрабатываться подсистемой копирования.

Возвращаемое значение

Тип: HRESULT

Любые другие HRESULT должны быть переданы. Если ошибка не обработана, возвращаемое значение должно быть hrError.

Код возврата Описание
COPYENGINE_S_USERRETRY
 Обработчик должен повторить операцию с файлом.
COPYENGINE_S_USERRETRYWITHNEWNAME
 Обработчик должен повторить операцию с файлом, используя имя, возвращаемое в буфере pszRename .
COPYENGINE_S_OVERWRITE
 Пользователь указал, что обработчик должен перезаписать существующий файл.
COPYENGINE_S_RETRYWITHOUTSECURITY
 Пользователь указал, что обработчик должен повторить операцию без дескриптора безопасности.
COPYENGINE_E_USERCANCELLED
 Пользователь нажал кнопку Отмена. Все задание копирования завершается. Обработчик должен вернуть этот код обратно в подсистему копирования.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)