Метод IVssComponent::GetPreRestoreFailureMsg (vswriter.h)
Метод GetPreRestoreFailureMsg извлекает сообщение об ошибке, созданное модулем записи при обработке события PreRestore , если IVssComponent::SetPreRestoreFailureMsg устанавливает его.
Этот метод может вызвать модуль записи или инициатор запроса.
Синтаксис
HRESULT GetPreRestoreFailureMsg(
[out] BSTR *pbstrPreRestoreFailureMsg
);
Параметры
[out] pbstrPreRestoreFailureMsg
Строка, содержащая сообщение о сбое, описывающее ошибку, которая произошла при обработке события PreRestore .
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Значение атрибута успешно возвращено. |
|
Не было доступно сообщение о сбое preRestore для получения. |
|
Одно из значений параметра является недопустимым. |
|
Вызывающий объект не имеет памяти или других системных ресурсов. |
|
Недопустимый 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::GetPostRestoreFailureMsg