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

Метод SetBackupStamp задает строку, содержащую сведения, указывающие, когда была создана резервная копия.

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

Этот метод нельзя вызвать при обработке события BackupComplete (CVssWriter::OnBackupComplete) или BackupShutdown (CVssWriter::OnBackupShutdown).

Синтаксис

HRESULT SetBackupStamp(
  [in] LPCWSTR wszBackupStamp
);

Параметры

[in] wszBackupStamp

Расширенные символьные сведения о строке символов, завершающиеся значением NULL, указывающие, когда выполнялось резервное копирование.

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

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

Значение Значение
S_OK
Метка времени резервного копирования успешно задана.
E_INVALIDARG
Одно из значений параметра недопустимо.
E_OUTOFMEMORY
У вызывающего объекта не хватает памяти или других системных ресурсов.
VSS_E_BAD_STATE
Этот метод не был вызван модулем записи, или при вызове модуля записи он либо не был вызван во время операции резервного копирования, либо был вызван при обработке события BackupComplete или BackupShutdown.

Комментарии

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

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

Средства записи обычно вызывают SetBackupStamp при обработке события PostSnapshot в CVssWriter::OnPostSnapshot.

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

Единственное применение метки резервной копии, которую запрашивающий объект создает во время операции восстановления, заключается в том, чтобы сделать сохраненную строку метки времени доступной для модуля записи с помощью метода IVssBackupComponents::SetPreviousBackupStamp .

По этой причине нет ограничений на формат содержимого метки резервной копии. Он может содержать сведения о времени и дате, логические порядковые номера или любые другие сведения, которые позволяют средству записи того же класса определить, когда была создана последняя резервная копия.

Требования

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

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

IVssComponent

IVssComponent::GetBackupStamp