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


Метод 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

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

CVssWriter

IVssWriterComponents