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

  • Статья

Метод GetPreviousBackupStamp возвращает предыдущую метку резервной копии, загруженную инициатором запроса в документе Компоненты резервного копирования. Значение используется модулем записи при принятии решения о том, должны ли файлы участвовать в разностном или добавочном резервном копировании.

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

Синтаксис

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Параметры

[out] pbstrBackupStamp

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

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

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

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

Комментарии

Дополнительные сведения о метках резервного копирования см. в разделах Роль записи в резервном копировании сложных хранилищ и Роль инициатора запроса в резервном копировании сложных хранилищ.

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

Если предыдущая метка времени резервного копирования отсутствует, getPreviousBackupStamp возвращает S_FALSE.

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

Метка резервной копии, полученная getPreviousBackupStamp , устанавливается инициатором запроса с помощью IVssBackupComponents::SetPreviousBackupStamp.

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

Требования

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

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

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent