Метод IVssComponent::GetBackupStamp (vswriter.h)
Метод GetBackupStamp возвращает строку метки резервной копии, хранящуюся модулем записи для данного компонента.
Этот метод может вызвать модуль записи или инициатор запроса.
Синтаксис
HRESULT GetBackupStamp(
[out] BSTR *pbstrBackupStamp
);
Параметры
[out] pbstrBackupStamp
Адрес переменной, выделенной вызывающей стороной, которая получает строку, содержащую метку резервного копирования, указывающую время резервного копирования компонента.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Значение атрибута успешно возвращено. |
|
С этим компонентом не связана метка времени. |
|
Одно из значений параметра является недопустимым. |
|
Вызывающий объект не имеет памяти или других системных ресурсов. |
|
Недопустимый 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 |