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

  • Статья

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

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

Синтаксис

HRESULT GetAdditionalRestores(
  [out] bool *pbAdditionalRestores
);

Параметры

[out] pbAdditionalRestores

Адрес переменной, выделенной вызывающей стороны, которая получает значение true , если для текущего компонента будут выполняться дополнительные операции восстановления, или значение false в противном случае.

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

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

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

Комментарии

Значение, возвращаемое Методом GetAdditionalRestores , будет иметь значение false, если во время операции восстановления запрашивающий объект не вызывает IVssBackupComponents::SetAdditionalRestores.

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

Метод GetAdditionalRestores обычно используется средствами записи, поддерживающими явный механизм восстановления в рамках обработчика событий PostRestore (CVssWriter::OnPostRestore), например, Exchange Server и приложений баз данных, таких как SQL Server. Для этих приложений часто невозможно выполнить дополнительное разностное, добавочное восстановление или восстановление журналов после такого восстановления.

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

Если setAdditionalRestores возвращает значение false, то после завершения восстановления при обработке события PostRestore модуль записи может завершить операцию восстановления и вернуться в режим "в сети".

Требования

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

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

IVssComponent