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

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

  • Статья

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

Синтаксис

HRESULT SubStreamFailure(
  [in] IShellItem *psi,
  [in] LPCWSTR    pszStreamName,
  [in] HRESULT    hrError
);

Параметры

[in] psi

Тип: IShellItem*

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

[in] pszStreamName

Тип: LPCWSTR

Имя данных, которые будут потеряны в операции.

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