VSS_SNAPSHOT_CONTEXT 枚举 (vss.h)

项目
03/13/2024

_VSS_SNAPSHOT_CONTEXT枚举允许使用 IVssBackupComponents：：SetContext 的请求者指定如何创建、查询或删除卷影副本以及编写器参与程度。

语法

typedef enum _VSS_SNAPSHOT_CONTEXT {
  VSS_CTX_BACKUP = 0,
  VSS_CTX_FILE_SHARE_BACKUP,
  VSS_CTX_NAS_ROLLBACK,
  VSS_CTX_APP_ROLLBACK,
  VSS_CTX_CLIENT_ACCESSIBLE,
  VSS_CTX_CLIENT_ACCESSIBLE_WRITERS,
  VSS_CTX_ALL = 0xffffffff
} VSS_SNAPSHOT_CONTEXT, *PVSS_SNAPSHOT_CONTEXT;

常量


`VSS_CTX_BACKUP` 值： 0 标准备份上下文。指定编写器所在的自动发布、非持久性卷影副本参与创建。
`VSS_CTX_FILE_SHARE_BACKUP` 指定在不涉及编写器的情况下创建的自动发布、非持久性卷影副本。
`VSS_CTX_NAS_ROLLBACK` 指定不涉及编写器的永久性非自动发布卷影副本。此上下文应为无需编写器参与以确保文件在当时处于一致状态时使用卷影副本的。轻型自动文件回滚机制或文件共享或数据卷的永久性卷影副本不应包含任何与系统相关的文件或数据库可能在此上下文中运行。 For 例如，请求者可以使用此上下文创建托管文档和的 NAS 卷的卷影副本简单用户共享。这些类型的数据不需要编写器参与，就可创建一致的卷影副本。
`VSS_CTX_APP_ROLLBACK` 指定具有编写器参与的永久性非自动发布卷影副本。此上下文设计为当需要编写器来确保文件在卷影复制之前处于定义良好的状态时使用。要用于数据挖掘或还原的系统卷和卷影副本的自动文件回滚机制操作可能在此上下文下运行。此上下文类似于 VSS_CTX_BACKUP 但允许请求者更好地控制卷影副本的持久性。
`VSS_CTX_CLIENT_ACCESSIBLE` 指定一个只读的、客户端可访问的卷影副本，该副本支持共享文件夹的卷影副本，并且创建时无需编写器参与。只有系统提供程序 (系统) 上提供的默认提供程序才能创建这种类型的卷影副本。大多数请求者希望将 VSS_CTX_NAS_ROLLBACK 上下文用于永久性的非自动发布卷影副本，而无需编写器参与。
`VSS_CTX_CLIENT_ACCESSIBLE_WRITERS` 指定在编写器参与的情况下创建的只读、客户端可访问的卷影副本。只有系统提供程序 (系统) 上提供的默认提供程序才能创建这种类型的卷影副本。大多数请求者希望将 VSS_CTX_APP_ROLLBACK 上下文用于具有编写器参与的永久性非自动发布卷影副本。 Windows Server 2003 和 Windows XP： Windows Server 2003 和 Windows XP 不支持此上下文。
`VSS_CTX_ALL` 值： 0xffffffff 所有类型的当前实时卷影副本都可用于管理操作，例如卷影复制查询 (请参阅 IVssBackupComponents：：Query) 。 VSS_CTX_ALL 是除 IVssBackupComponents：：StartSnapshotSet 和 IVssBackupComponents：:D oSnapshotSet。

注解

要与 _VSS_SNAPSHOT_CONTEXT 值一起使用的数据类型为 LONG。

VSS 卷影副本的默认上下文为 VSS_CTX_BACKUP。

Windowsxp： 唯一支持的上下文是默认值 ，VSS_CTX_BACKUP。调用 IVssBackupComponents：：SetContext 将返回 E_NOTIMPL。

有关如何使用 VSS 卷影副本上下文的详细信息，请参阅创建卷影副本的实现详细信息。

通过使用按位或将受支持的 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 与有效的 _VSS_SNAPSHOT_CONTEXT 值合并为 IVssBackupComponents：：SetContext 方法的参数，可以进一步控制卷影复制行为。

目前，唯一支持的修改是具有VSS_VOLSNAP_ATTR_TRANSPORTABLE的_VSS_SNAPSHOT_CONTEXT值的按位 OR，以及_VSS_VOLUME_SNAPSHOT_ATTRIBUTES枚举的VSS_VOLSNAP_ATTR_DIFFERENTIAL或VSS_VOLSNAP_ATTR_PLEX值。

但是，这些值不能用于修改 VSS_CTX_CLIENT_ACCESSIBLE 上下文。

VSS_VOLSNAP_ATTR_TRANSPORTABLE的使用仅限于运行 Windows Server 2008 Enterprise、Windows Server 2008 Datacenter、Windows Server 2003、Enterprise Edition或 Windows Server 2003 Datacenter Edition 的系统。