Метод CVssWriter::OnPrepareSnapshot (vswriter.h)

  • Статья

Метод OnPrepareSnapshot вызывается модулем записи для обработки события PrepareForSnapshot . Он используется для выполнения операций, необходимых для подготовки модуля записи к участию в теневой копии или для вето на теневой копии.

OnPrepareSnapshot — это чисто виртуальный метод. Он не реализуется базовым классом CVssWriter и должен быть реализован производными классами.

Синтаксис

bool OnPrepareSnapshot();

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

Реализация этого метода должна возвращать значение true , за исключением случаев неустранимой ошибки. При возникновении неустранимой ошибки метод должен вызвать метод CVssWriter::SetWriterFailure , чтобы предоставить описание сбоя, прежде чем возвращать значение false. Если возникает некритичная ошибка, метод должен по-прежнему вызывать SetWriterFailure , но возвращать значение true. Если ошибка вызвана временной проблемой, метод должен указать VSS_E_WRITERERROR_RETRYABLE в вызове SetWriterFailure.

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

Комментарии

Метод OnPrepareSnapshot выполняет операции, необходимые до заморозки теневой копии.

Время ожидания для обработки события PrepareForSnapshot обычно превышает время ожидания для обработки события Freeze . Поэтому разработчики могут использовать OnPrepareSnapshot для обработки более длительных операций. Обычно модуль записи используется для явного создания контрольных точек для своих данных.

Модули записи никогда не должны вызывать исключение из этого метода или любого другого метода обратного вызова CVssWriter(Ex)::OnXxx .

Если этот метод вызывает метод CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure или CVssWriterEx2::SetWriterFailureEx , он должен сделать это в том же потоке, который вызвал этот метод. Дополнительные сведения см. в разделе Обработка событий записи.

Требования

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

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

CVssWriter

CVssWriter::OnAbort

CVssWriter::OnFreeze

CVssWriter::OnThaw

CVssWriter::SetWriterFailure