Метод IVssComponentEx2::SetFailure (vswriter.h)

  • Статья

Модули записи VSS вызывают этот метод, чтобы сообщить об ошибках на уровне компонента.

Синтаксис

HRESULT SetFailure(
  [in] HRESULT hr,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage,
  [in] DWORD   dwReserved
);

Параметры

[in] hr

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

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

Значение Значение
S_OK
 Писатель был успешным.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
 Теневая копия содержит только подмножество томов, необходимых средству записи для правильного резервного копирования компонента приложения.
VSS_E_WRITERERROR_OUTOFRESOURCES
 В средстве записи закончилась память или другие системные ресурсы. Рекомендуемый способ обработки этого кода ошибки — подождать десять минут, а затем повторить операцию до трех раз.
VSS_E_WRITERERROR_TIMEOUT
 Операция записи завершилась сбоем из-за времени ожидания между событиями заморозки и оттепели. Рекомендуемый способ обработки этого кода ошибки — подождать десять минут, а затем повторить операцию до трех раз.
VSS_E_WRITERERROR_RETRYABLE
 Сбой модуля записи из-за ошибки, которая, скорее всего, не возникнет, если был перезапущен весь процесс создания резервной копии, восстановления или теневой копии. Рекомендуемый способ обработки этого кода ошибки — подождать десять минут, а затем повторить операцию до трех раз.
VSS_E_WRITERERROR_NONRETRYABLE
 Операция записи завершилась сбоем из-за ошибки, которая может повторяться при создании другой теневой копии. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.

[in] hrApplication

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

[in] wszApplicationMessage

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

[in] dwReserved

Этот параметр зарезервирован для использования в будущем и должен иметь нулевое значение.

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

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

Комментарии

Помимо вызова этого метода, используйте метод CVssWriterEx2::SetWriterFailureEx , чтобы сообщить о частичном сбое записи.

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

Требования

   
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header vswriter.h

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

IVssComponentEx2