Метод IVssComponent::GetPreRestoreFailureMsg (vswriter.h)

Метод GetPreRestoreFailureMsg извлекает сообщение об ошибке, созданное модулем записи при обработке события PreRestore , если IVssComponent::SetPreRestoreFailureMsg устанавливает его.

Этот метод может вызвать модуль записи или инициатор запроса.

Синтаксис

HRESULT GetPreRestoreFailureMsg(
  [out] BSTR *pbstrPreRestoreFailureMsg
);

Параметры

[out] pbstrPreRestoreFailureMsg

Строка, содержащая сообщение о сбое, описывающее ошибку, которая произошла при обработке события PreRestore .

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

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

Значение Значение
S_OK
Значение атрибута успешно возвращено.
S_FALSE
Не было доступно сообщение о сбое preRestore для получения.
E_INVALIDARG
Одно из значений параметра является недопустимым.
E_OUTOFMEMORY
Вызывающий объект не имеет памяти или других системных ресурсов.
VSS_E_INVALID_XML_DOCUMENT
Недопустимый XML-документ. Дополнительные сведения см. в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.

Комментарии

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

Если setPreRestoreFailureMsg не использовался для задания сообщения об ошибке PreRestore , GetPreRestoreFailureMsg возвращает S_FALSE.

Требования

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

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

IVssComponent

IVssComponent::GetPostRestoreFailureMsg

IVssComponent::SetPostRestoreFailureMsg

IVssComponent::SetPreRestoreFailureMsg