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

  • Статья

Метод GetBackupStamp возвращает строку метки резервной копии, хранящуюся модулем записи для данного компонента.

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

Синтаксис

HRESULT GetBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Параметры

[out] pbstrBackupStamp

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

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

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

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

Комментарии

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

Если вызов GetBackupStamp выполнен успешно, вызывающий объект отвечает за освобождение строки, возвращаемой в параметре pbstrBackupStamp , путем вызова функции SysFreeString .

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

Метка резервной копии, полученная GetBackupStamp , обычно устанавливается модулем записи путем вызова IVssComponent::SetBackupStamp из обработчика событий PostSnapshotCVssWriter::OnPostSnapshot.

Инициаторы запроса просто сохраняют метки резервных копий в документе Компоненты резервного копирования; они не используют метку резервного копирования напрямую, не знают, как ее создать или не понимают ее формат.

Требования

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

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

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent

IVssComponent::SetBackupStamp