Метод CVssWriter::OnPostRestore (vswriter.h)
Метод OnPostRestore вызывается модулем записи после события PostRestore . Он используется для выполнения операций, которые считаются необходимыми после восстановления файлов на диск инициатором запроса. Однако эти операции не могут изменить документ компонентов резервного копирования.
OnPostRestore — это виртуальный метод. Он реализуется базовым классом CVssWriter , но может быть переопределен производными классами.
Синтаксис
bool OnPostRestore(
[in] IVssWriterComponents *pComponent
);
Параметры
[in] pComponent
Указатель на объект IVssWriterComponents , передаваемый VSS для предоставления методу доступа к сведениям о компоненте модуля записи. Значение этого параметра может иметь значение NULL, если инициатор запроса не поддерживает компоненты (если функция CVssWriter::AreComponentsElected возвращает значение false).
Возвращаемое значение
Как реализуется базовым классом, OnPostRestore всегда возвращает значение true.
Любая другая реализация этого метода должна возвращать значение true , за исключением случаев неустранимой ошибки. При возникновении неустранимой ошибки метод должен вызвать метод CVssWriter::SetWriterFailure , чтобы предоставить описание сбоя, прежде чем возвращать значение false. Если возникает некритичная ошибка, метод должен по-прежнему вызывать SetWriterFailure, но возвращатьзначение true. Если ошибка вызвана временной проблемой, метод должен указать VSS_E_WRITERERROR_RETRYABLE в вызове Метода SetWriterFailure.
Во всех случаях, когда происходит сбой, метод должен записывать событие в журнал событий, чтобы сообщить точную причину сбоя.
Комментарии
Реализация этого метода по умолчанию базовым классом CVssWriter возвращает значение true без выполнения каких-либо других операций.
При необходимости модуль записи должен удалить все временные файлы и освободить все системные ресурсы, необходимые для участия в восстановлении.
Записи никогда не должны вызывать исключение из этого метода или любого другого метода обратного вызова CVssWriter(Ex)::OnXxx .
При создании события PostRestore документ компонентов резервного копирования инициатора запроса становится документом, доступным только для чтения. Поэтому попытки изменить документ с помощью интерфейса (например, вызов IVssComponent::SetRestoreMetadata) завершатся ошибкой в пользовательских реализациях OnPostRestore.
Если этот метод вызывает метод CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure или CVssWriterEx2::SetWriterFailureEx , он должен делать это в том же потоке, который вызвал этот метод. Дополнительные сведения см. в разделе Обработка событий записи.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vswriter.h (включая Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |