Метод IVssBackupComponents::SetContext (vsbackup.h)
Метод SetContext задает контекст для последующих операций, связанных с теневым копированием.
Синтаксис
HRESULT SetContext(
[in] LONG lContext
);
Параметры
[in] lContext
Задается контекст. Контекст должен быть одним из поддерживаемых значений _VSS_SNAPSHOT_CONTEXT или поддерживаемой битовой маской (или побитовой или) _VSS_VOLUME_SNAPSHOT_ATTRIBUTES с допустимым _VSS_SNAPSHOT_CONTEXT.
Возвращаемое значение
Возвращаемое по умолчанию значение этого метода — S_OK. Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Контекст успешно задан. |
|
Одно из значений параметра недопустимо. |
|
Объект компонентов резервного копирования не инициализирован, этот метод был вызван во время операции восстановления или этот метод не был вызван в правильной последовательности. |
|
Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
Комментарии
Контекст по умолчанию для теневых копий VSS — VSS_CTX_BACKUP.
Windows XP: Единственным поддерживаемым контекстом является контекст по умолчанию, VSS_CTX_BACKUP. Таким образом, вызов SetContext в Windows XP возвращает E_NOTIMPL.
Метод SetContext можно вызвать только один раз, и его необходимо вызвать перед вызовом большинства функций VSS.
Дополнительные сведения о том, как контекст, заданный IVssBackupComponents::SetContext , влияет на создание теневой копии и управление ими, см. в разделе Сведения о реализации для создания теневых копий.
Полное описание разрешенных контекстов теневого копирования см. в разделе _VSS_SNAPSHOT_CONTEXT и _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |
См. также раздел
IVssBackupComponents::D oSnapshotSet