VSS_SNAPSHOT_CONTEXT-Enumeration (vss.h)

Artikel
03/03/2024

Mit der _VSS_SNAPSHOT_CONTEXT-Enumeration kann ein Anforderer mithilfe von IVssBackupComponents::SetContext angeben, wie eine Schattenkopie erstellt, abgefragt oder gelöscht werden soll und wie der Grad der Writer-Beteiligung ist.

Syntax

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;

Konstanten


`VSS_CTX_BACKUP` Wert: 0 Der Standardsicherungskontext. Gibt eine nichtpersistente Schattenkopie mit automatischer Freigabe an, in der sich Autoren befinden. an der Erstellung beteiligt.
`VSS_CTX_FILE_SHARE_BACKUP` Gibt eine automatisch freigegebene, nichtpersistente Schattenkopie an, die ohne Einbindung des Writers erstellt wird.
`VSS_CTX_NAS_ROLLBACK` Gibt eine persistente Schattenkopie ohne Automatische Freigabe ohne Einbindung des Writers an. Dieser Kontext sollte wird verwendet, wenn keine Einbindung des Writers erforderlich ist, um sicherzustellen, dass sich Dateien zu diesem Zeitpunkt in einem konsistenten Zustand befinden der Schattenkopie. Einfache automatisierte Dateirollbackmechanismen oder persistente Schattenkopien von Dateifreigaben oder Datenvolumes von denen erwartet wird, dass sie keine systembezogenen Dateien enthalten, oder Datenbanken können unter diesem Kontext ausgeführt werden. Für Beispiel: Ein Anforderer könnte diesen Kontext verwenden, um eine Schattenkopie eines NAS-Volumes zu erstellen, das Dokumente hostt. einfache Benutzerfreigaben. Für diese Datentypen ist die Einbindung des Writers nicht erforderlich, um eine konsistente Schattenkopie zu erstellen.
`VSS_CTX_APP_ROLLBACK` Gibt eine persistente Schattenkopie ohne automatische Freigabe mit Writer-Beteiligung an. Dieser Kontext ist konzipiert. wird verwendet, wenn Writer benötigt werden, um sicherzustellen, dass sich Dateien vor der Schattenkopie in einem klar definierten Zustand befinden. Automatisierte Dateirollbackmechanismen von Systemvolumes und Schattenkopien, die bei Data Mining oder Wiederherstellung verwendet werden sollen Vorgänge können unter diesem Kontext ausgeführt werden. Dieser Kontext ähnelt VSS_CTX_BACKUP ermöglicht einem Anforderer jedoch mehr Kontrolle über die Persistenz der Schattenkopie.
`VSS_CTX_CLIENT_ACCESSIBLE` Gibt eine schreibgeschützte Schattenkopie mit Clientzugriff an , die Schattenkopien für freigegebene Ordner unterstützt und ohne Einbindung des Writers erstellt wird. Nur der Systemanbieter (der auf dem System verfügbare Standardanbieter) kann diese Art von Schattenkopie erstellen. Die meisten Anforderer möchten den VSS_CTX_NAS_ROLLBACK-Kontext für dauerhafte Schattenkopien verwenden, die keine automatische Freigabe enthalten, ohne dass der Writer beteiligt ist.
`VSS_CTX_CLIENT_ACCESSIBLE_WRITERS` Gibt eine schreibgeschützte, vom Client zugängliche Schattenkopie an , die mit Der Einbindung des Writers erstellt wird. Nur der Systemanbieter (der auf dem System verfügbare Standardanbieter) kann diese Art von Schattenkopie erstellen. Die meisten Anforderer möchten den VSS_CTX_APP_ROLLBACK Kontext für permanente Schattenkopien ohne automatische Freigabe mit Writer-Beteiligung verwenden. Windows Server 2003 und Windows XP: Dieser Kontext wird von Windows Server 2003 und Windows XP nicht unterstützt.
`VSS_CTX_ALL` Wert: 0xffffffff Alle Arten von derzeit aktiven Schattenkopien sind für administrative Vorgänge verfügbar, z. B. Schattenkopien abfragen (siehe IVssBackupComponents::Query). VSS_CTX_ALL ist ein gültiger Kontext für alle VSS-Schnittstellen außer IVssBackupComponents::StartSnapshotSet und IVssBackupComponents::D oSnapshotSet.

Hinweise

Der Datentyp, der mit Werten von _VSS_SNAPSHOT_CONTEXT verwendet werden soll, ist LONG.

Der Standardkontext für VSS-Schattenkopien ist VSS_CTX_BACKUP.

Windows XP: Der einzige unterstützte Kontext ist der Standardkontext , VSS_CTX_BACKUP. Beim Aufrufen von IVssBackupComponents::SetContext wird E_NOTIMPL zurückgegeben.

Ausführliche Informationen zur Verwendung von VSS-Schattenkopienkontexten finden Sie unter Implementierungsdetails zum Erstellen von Schattenkopien.

Das Verhalten von Schattenkopien kann weiter gesteuert werden, indem ein bitweiser OR verwendet wird, um eine unterstützte _VSS_VOLUME_SNAPSHOT_ATTRIBUTES mit gültigen _VSS_SNAPSHOT_CONTEXT-Werten als Argument für die IVssBackupComponents::SetContext-Methode zu kombinieren.

Derzeit werden nur die bitweise ODER eines _VSS_SNAPSHOT_CONTEXT Werts mit dem VSS_VOLSNAP_ATTR_TRANSPORTABLE und entweder der VSS_VOLSNAP_ATTR_DIFFERENTIAL oder der VSS_VOLSNAP_ATTR_PLEX-Wert der _VSS_VOLUME_SNAPSHOT_ATTRIBUTES-Enumeration unterstützt.

Diese Werte können jedoch nicht verwendet werden, um VSS_CTX_CLIENT_ACCESSIBLE Kontext zu ändern.

Die Verwendung von VSS_VOLSNAP_ATTR_TRANSPORTABLE ist auf Systeme beschränkt, auf denen Windows Server 2008 Enterprise, Windows Server 2008 Datacenter, Windows Server 2003, Enterprise Edition oder Windows Server 2003, Datacenter Edition ausgeführt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	vss.h

Weitere Informationen

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Freigeben über