Метод CVssWriterEx2::SetWriterFailureEx (vswriter.h)

  • Статья

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

Синтаксис

HRESULT SetWriterFailureEx(
  [in] HRESULT hrWriter,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage
);

Параметры

[in] hrWriter

Код ошибки, возвращаемый инициатору запроса.

Ниже приведены коды ошибок, которые может задать этот метод.

Значение Значение
S_OK
 Писатель был успешным.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
 Теневая копия содержит только подмножество томов, необходимых средству записи для правильного резервного копирования компонента приложения.
VSS_E_WRITERERROR_OUTOFRESOURCES
 У модуля записи не хватает памяти или других системных ресурсов. Для обработки этого кода ошибки рекомендуется подождать десять минут, а затем повторить операцию до трех раз.
VSS_E_WRITERERROR_TIMEOUT
 Операция записи завершилась сбоем из-за истечения времени ожидания между событиями Freeze и Thaw. Для обработки этого кода ошибки рекомендуется подождать десять минут, а затем повторить операцию до трех раз.
VSS_E_WRITERERROR_RETRYABLE
 Сбой модуля записи из-за ошибки, которая, скорее всего, не произойдет, если был перезапущен весь процесс резервного копирования, восстановления или создания теневой копии. Для обработки этого кода ошибки рекомендуется подождать десять минут, а затем повторить операцию до трех раз.
VSS_E_WRITERERROR_NONRETRYABLE
 Операция записи завершилась сбоем из-за ошибки, которая может повторяться при создании другой теневой копии. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
VSS_E_WRITERERROR_PARTIAL_FAILURE
 Модуль записи сообщает об одной или нескольких ошибках на уровне компонентов. Чтобы сообщить об ошибках, модуль записи должен использовать метод IVssComponentEx2::SetFailure .

[in] hrApplication

Дополнительный код ошибки, возвращаемый инициатору запроса. Этот параметр является необязательным.

[in] wszApplicationMessage

Строка, содержащая сообщение об ошибке для инициатора запроса, которое будет отображаться для конечного пользователя. Модуль записи отвечает за локализацию этой строки, если это необходимо, прежде чем использовать ее в этом методе. Этот параметр является необязательным и может иметь значение NULL или пустую строку.

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод нельзя вызвать из CVssWriter::OnIdentify или CVssWriterEx::OnIdentifyEx.

Чтобы сообщить об ошибках на уровне компонентов, записи должны использовать метод IVssComponentEx2::SetFailure .

Если обработчик событий модуля записи (например , CVssWriter::OnFreeze) вызывает этот метод, он должен делать это в том же потоке, который вызвал обработчик событий. Дополнительные сведения см. в разделе Обработка событий записи.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header vswriter.h (включая Vss.h, VsWriter.h)
Библиотека VssApi.lib

См. также раздел

CVssWriter::SetWriterFailure

CVssWriterEx2

IVssBackupComponentsEx3::GetWriterStatusEx