Метод IVssComponent::SetBackupStamp (vswriter.h)
Метод SetBackupStamp задает строку, содержащую сведения, указывающие на момент создания резервной копии.
Модуль записи может вызывать этот метод только во время операции резервного копирования.
Этот метод нельзя вызвать при обработке события BackupComplete (CVssWriter::OnBackupComplete) или BackupShutdown (CVssWriter::OnBackupShutdown).
Синтаксис
HRESULT SetBackupStamp(
[in] LPCWSTR wszBackupStamp
);
Параметры
[in] wszBackupStamp
Сведения о строке расширенных символов, завершающиеся значением NULL, указывающие на момент создания резервной копии.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Метка времени резервного копирования успешно задана. |
|
Одно из значений параметров недопустимо. |
|
Вызывающий объект не хватает памяти или других системных ресурсов. |
|
Этот метод не был вызван средством записи или, если вызывается средством записи, он либо не был вызван во время операции резервного копирования, либо был вызван при обработке события BackupComplete или BackupShutdown. |
Комментарии
Дополнительные сведения о метках резервных копий см. в разделе "Роль модуля записи" в резервном копировании сложных хранилищ.
Набор меток резервной копии setBackupStamp применяется ко всем файлам в компоненте и к любым неизбираемым вложенным компонентам.
Записи обычно вызывают SetBackupStamp при обработке события PostSnapshot в CVssWriter::OnPostSnapshot.
Инициаторы запроса просто хранят метку резервной копии в документе "Компоненты резервного копирования". Они не используют метку резервной копии напрямую или не должны знать, как ее интерпретировать.
Единственное использование метки резервной копии, которую выполняет инициатор запроса во время операции восстановления, — сделать сохраненную строку метки времени доступной для модуля записи с помощью метода IVssBackupComponents::SetPreviousBackupStamp .
По этой причине нет ограничений на формат содержимого метки резервной копии. Он может содержать сведения о времени и дате, логические порядковые номера или любые другие сведения, позволяющие средству записи того же класса определить, когда произошла последняя резервная копия.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vswriter.h (include Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |