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

Метод GetPostRestoreFailureMsg возвращает сообщение об ошибке, созданное модулем записи при обработке события PostRestore , если IVssComponent::SetPostRestoreFailureMsg задано значение .

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

Синтаксис

HRESULT GetPostRestoreFailureMsg(
  [out] BSTR *pbstrPostRestoreFailureMsg
);

Параметры

[out] pbstrPostRestoreFailureMsg

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

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

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

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

Комментарии

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

Если setPostRestoreFailureMsg не использовался для задания сообщения об ошибке PostRestore , getPreRestoreFailureMsg возвращает S_FALSE.

Требования

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

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

IVssComponent

IVssComponent::GetPreRestoreFailureMsg

IVssComponent::SetPostRestoreFailureMsg

IVssComponent::SetPreRestoreFailureMsg