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

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

  • Статья

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

Синтаксис

HRESULT GetFailure(
  [out] HRESULT *phr,
  [out] HRESULT *phrApplication,
  [out] BSTR    *pbstrApplicationMessage,
  [out] DWORD   *pdwReserved
);

Параметры

[out] phr

Адрес переменной, выделенной вызывающим объектом, которая получает код сбоя HRESULT, переданный модулем hr метода IVssComponentEx2::SetFailure. Этот параметр является обязательным и не может иметь значение NULL.

Ниже приведены поддерживаемые значения.

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

[out] phrApplication

Адрес переменной, выделенной вызывающей стороны, которая получает код возврата, переданный модулем записи для параметра hrApplication метода SetFailure . Этот параметр является обязательным и не может иметь значение NULL.

[out] pbstrApplicationMessage

Адрес переменной, выделенной вызывающим объектом, которая получает сообщение о сбое приложения, переданное модулем записи для параметра wszApplicationMessage метода SetFailure . Этот параметр является обязательным и не может иметь значение NULL.

[out] pdwReserved

Адрес переменной DWORD, выделенной вызывающим объектом. Этот параметр зарезервирован для использования в будущем, но он является обязательным и не может иметь значение NULL.

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

Ниже приведены допустимые коды возврата для этого метода.

Значение Значение
S_OK
0x00000000L
 Успешно возвращено состояние указанного модуля записи. Обратите внимание, что для проверки успешности записи необходимо проверить значение параметра phrFailureWriter . Коды ошибок записи могут находиться в списке в VsWriter.h, а также в разделе Ошибки и вето записи.
E_INVALIDARG
0x80070057L
 Параметр phr, phrApplication, pbstrApplicationMessage или pdwReserved имеет значение NULL.
E_OUTOFMEMORY
0x8007000EL
 Вызывающий объект не имеет памяти или других системных ресурсов.
VSS_E_BAD_STATE
0x80042301L
 Объект компонента резервной копии не инициализирован, этот метод был вызван во время операции восстановления или этот метод не был вызван в правильной последовательности.

Комментарии

Когда вызывающий объект завершит доступ к сведениям о состоянии, возвращенным этим методом, он должен вызвать SysFreeString , чтобы освободить память, удерживаемую параметром pbstrApplicationMessage .

Требования

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

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

IVssComponentEx2