VSS_VOLUME_SNAPSHOT_ATTRIBUTES-Enumeration (vss.h)

Artikel
08/27/2023

Ermöglicht die Angabe zusätzlicher Attribute für eine Schattenkopie. Der Kontext einer Schattenkopie (wie von der IVssBackupComponents::SetContext-Methode festgelegt) kann durch eine Bitmaske geändert werden, die eine gültige Kombination aus _VSS_VOLUME_SNAPSHOT_ATTRIBUTES und _VSS_SNAPSHOT_CONTEXT Enumerationswerten enthält.

Syntax

typedef enum _VSS_VOLUME_SNAPSHOT_ATTRIBUTES {
  VSS_VOLSNAP_ATTR_PERSISTENT = 0x1,
  VSS_VOLSNAP_ATTR_NO_AUTORECOVERY = 0x2,
  VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE = 0x4,
  VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE = 0x8,
  VSS_VOLSNAP_ATTR_NO_WRITERS = 0x10,
  VSS_VOLSNAP_ATTR_TRANSPORTABLE = 0x20,
  VSS_VOLSNAP_ATTR_NOT_SURFACED = 0x40,
  VSS_VOLSNAP_ATTR_NOT_TRANSACTED = 0x80,
  VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED = 0x10000,
  VSS_VOLSNAP_ATTR_DIFFERENTIAL = 0x20000,
  VSS_VOLSNAP_ATTR_PLEX = 0x40000,
  VSS_VOLSNAP_ATTR_IMPORTED = 0x80000,
  VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY = 0x100000,
  VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY = 0x200000,
  VSS_VOLSNAP_ATTR_AUTORECOVER = 0x400000,
  VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY = 0x800000,
  VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT = 0x1000000,
  VSS_VOLSNAP_ATTR_TXF_RECOVERY = 0x2000000,
  VSS_VOLSNAP_ATTR_FILE_SHARE = 0x4000000
} VSS_VOLUME_SNAPSHOT_ATTRIBUTES, *PVSS_VOLUME_SNAPSHOT_ATTRIBUTES;

Konstanten


`VSS_VOLSNAP_ATTR_PERSISTENT` Wert: 0x1 Die Schattenkopie ist bei Neustarts persistent. Dieses Attribut wird automatisch für festgelegt _VSS_SNAPSHOT_CONTEXT Kontexte von VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS und VSS_CTX_NAS_ROLLBACK. Dieses Attribut sollte nicht explizit von Anforderern verwendet werden, wenn sie den Kontext einer Schattenkopie festlegen.
`VSS_VOLSNAP_ATTR_NO_AUTORECOVERY` Wert: 0x2 Die automatische Wiederherstellung ist für die Schattenkopie deaktiviert. Ein Anforderer kann einen Schattenkopiekontext mit einem bitweisen OR dieses Attributs ändern. Dadurch weist der Anforderer VSS an, die Schattenkopie unmittelbar nach der Erstellung schreibgeschützt zu machen, ohne dass Autoren oder andere Anwendungen Komponenten in der Schattenkopie aktualisieren können. Die Deaktivierung der automatischen Wiederherstellung kann dazu führen, dass sich die Schattenkopie in einem inkonsistenten Zustand befindet, wenn eine ihrer Komponenten an transaktionenalen Datenbankvorgängen beteiligt ist, z. B. transaktionsbasierte Lese- und Schreibvorgänge, die von Transactional NTFS (TxF) verwaltet werden. Dies liegt daran, dass das Deaktivieren der automatischen Wiederherstellung verhindert, dass unvollständige Transaktionen zurückgesetzt werden. Das Deaktivieren der automatischen Wiederherstellung verhindert außerdem, dass Autoren Dateien aus der Schattenkopie ausschließen. Wenn die automatische Wiederherstellung deaktiviert ist, kann ein Writer weiterhin die IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot-Methode aufrufen, aber die CVssWriter::OnPostSnapshot-Methode des Writers kann die Dateien nicht aus der Schattenkopie löschen. Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Vista unterstützt.
`VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE` Wert: 0x4 Die angegebene Schattenkopie ist eine vom Client zugängliche Schattenkopie , die Schattenkopien für freigegebene Ordner unterstützt und nicht verfügbar gemacht werden sollte. Dieses Attribut wird automatisch für VSS_CTX_CLIENT_ACCESSIBLE und VSS_CTX_CLIENT_ACCESSIBLE_WRITERS festgelegt. Dieses Attribut sollte nicht explizit von Anforderern verwendet werden, wenn sie den Kontext einer Schattenkopie festlegen.
`VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE` Wert: 0x8 Die Schattenkopie wird nicht automatisch gelöscht, wenn der Schattenkopie-Anfordererprozess endet. Die Schattenkopie kann nur durch einen Aufruf von gelöscht werden IVssBackupComponents::D eleteSnapshots. Dieses Attribut wird automatisch für festgelegt _VSS_SNAPSHOT_CONTEXT Kontexte von VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS und VSS_CTX_NAS_ROLLBACK. Dieses Attribut sollte nicht explizit von Anforderern verwendet werden, wenn sie den Kontext einer Schattenkopie festlegen.
`VSS_VOLSNAP_ATTR_NO_WRITERS` Wert: 0x10 An der Erstellung der Schattenkopie sind keine Autoren beteiligt. Dieses Attribut wird automatisch für festgelegt _VSS_SNAPSHOT_CONTEXT Kontexte von VSS_CTX_NAS_ROLLBACK, VSS_CTX_FILE_SHARE_BACKUP und VSS_CTX_CLIENT_ACCESSIBLE. Dieses Attribut sollte nicht explizit von Anforderern verwendet werden, wenn sie den Kontext einer Schattenkopie festlegen.
`VSS_VOLSNAP_ATTR_TRANSPORTABLE` Wert: 0x20 Die Schattenkopie soll transportiert werden und sollte daher nicht lokal aufgetaucht werden. Dieses Attribut kann explizit von Anforderern beim Festlegen des Kontexts einer Schattenkopie verwendet werden, wenn Anbieter für Schattenkopien unterstützt transportierbare Schattenkopien. Windows Server 2003, Standard Edition, Windows Server 2003, Web Edition und Windows XP: Dieses Attribut wird nicht unterstützt. Dieses Attribut wird von allen Editionen von Windows Server 2003 mit SP1 unterstützt. Siehe Importieren von Transportablen Schatten kopierte Volumes für weitere Informationen.
`VSS_VOLSNAP_ATTR_NOT_SURFACED` Wert: 0x40 Die Schattenkopie wird derzeit nicht verfügbar gemacht. Sofern die Schattenkopie nicht explizit verfügbar gemacht oder eingebunden wird, wird dieses Attribut für alle Schattenkopien festgelegt. Dieses Attribut sollte nicht explizit von Anforderern verwendet werden, wenn sie den Kontext einer Schattenkopie festlegen.
`VSS_VOLSNAP_ATTR_NOT_TRANSACTED` Wert: 0x80 Die Schattenkopie wird nicht abgewickelt. Ein Anforderer kann einen Schattenkopiekontext mit einem bitweisen OR dieses Attributs ändern. Dadurch weist der Anforderer VSS an, die integrierte Integration zwischen VSS und Transaktions- und Ressourcen-Managern zu deaktivieren. Durch Festlegen dieses Attributs wird sichergestellt, dass der Anforderer keine VSS_E_TRANSACTION_FREEZE_TIMEOUT Fehler empfängt. Dies kann jedoch zu unerwünschten Folgen führen, z. B. verlust der Transaktionsintegrität oder sogar Datenverlust. Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Vista unterstützt.
`VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED` Wert: 0x10000 Gibt an, dass ein bestimmter Anbieter ein Hardwareanbieter ist. Dieses Attribut wird automatisch für Hardwareanbieter festgelegt. Dieser Enumerationswert kann nicht verwendet werden, um den Kontext manuell festzulegen (mit dem IVssBackupComponents::SetContext -Methode) einer Schattenkopie durch eine Bitmaske (oder bitweise OR) dieses Enumerationswerts und einer gültigen Schattenkopie Kontextwert aus _VSS_SNAPSHOT_CONTEXT.
`VSS_VOLSNAP_ATTR_DIFFERENTIAL` Wert: 0x20000 Gibt an, dass ein bestimmter Anbieter differenzielle Daten oder einen Kopier-beim-Schreibmechanismus verwendet, um Schattenkopien zu implementieren. Ein Anforderer kann einen Schattenkopiekontext mit einem bitweisen OR dieses Attributs ändern. Dadurch wird die Der Anforderer weist Anbieter an, mithilfe einer differenziellen Implementierung eine Schattenkopie zu erstellen. Wenn keine Schattenkopie Der auf dem System installierte Anbieter unterstützt die angeforderten Attribute. Ein VSS_E_VOLUME_NOT_SUPPORTED Fehler ist zurückgegeben an IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_PLEX` Wert: 0x40000 Gibt an, dass ein bestimmter Anbieter einen PLEX- oder gespiegelten Splitmechanismus verwendet, um Schattenkopien zu implementieren. Ein Anforderer kann einen Schattenkopiekontext mit einem bitweisen OR dieses Attributs ändern. Dadurch wird die Der Anforderer weist die Anbieter an, mithilfe einer PLEX-Implementierung eine Schattenkopie zu erstellen. Wenn keine Schattenkopie Der auf dem System installierte Anbieter unterstützt die angeforderten Attribute. Ein VSS_E_VOLUME_NOT_SUPPORTED Fehler ist zurückgegeben an IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_IMPORTED` Wert: 0x80000 Die Schattenkopie des Volumes wurde mit dem IVssBackupComponents::ImportSnapshots -Methode statt mit dem IVssBackupComponents::D oSnapshotSet -Methode. Dieses Attribut wird automatisch festgelegt, wenn eine Schattenkopie importiert wird. Dieses Attribut sollte nicht explizit von Anforderern verwendet werden, wenn sie den Kontext einer Schattenkopie festlegen.
`VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY` Wert: 0x100000 Die Schattenkopie wird lokal verfügbar gemacht. Wenn dieses Bitflag und das VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY Bitflag nicht festgelegt, die Schattenkopie ist ausgeblendet. Das -Attribut wird automatisch einem Schattenkopiekontext hinzugefügt, wenn das -Element aufgerufen wird. IVssBackupComponents::ExposeSnapshot -Methode, um eine Schattenkopie lokal verfügbar zu machen. Dieses Attribut sollte vom Anforderer nicht explizit verwendet werden, wenn der Kontext einer Schattenkopie festgelegt wird.
`VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY` Wert: 0x200000 Die Schattenkopie wird remote verfügbar gemacht. Wenn dieses Bitflag und das VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY Bitflag nicht festgelegt, die Schattenkopie ist ausgeblendet. Das -Attribut wird automatisch einem Schattenkopiekontext hinzugefügt, wenn das -Element aufgerufen wird. IVssBackupComponents::ExposeSnapshot -Methode, um eine Schattenkopie lokal verfügbar zu machen. Dieses Attribut sollte vom Anforderer nicht explizit verwendet werden, wenn der Kontext einer Schattenkopie festgelegt wird.
`VSS_VOLSNAP_ATTR_AUTORECOVER` Wert: 0x400000 Gibt an, dass der Writer die Komponente in CVssWriter::OnPostSnapshot automatisch wiederherstellen muss. Dieses Attribut sollte vom Anforderer nicht explizit verwendet werden, wenn der Kontext einer Schattenkopie festgelegt wird.
`VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY` Wert: 0x800000 Gibt an, dass der Writer die Komponente in CVssWriter::OnPostSnapshot automatisch wiederherstellen muss, wenn die Schattenkopie für ein Rollback verwendet wird (z. B. für Data Mining). Ein Anforderer würde dieses Flag im Schattenkopiekontext festlegen, um anzugeben, dass die Schattenkopie für einen Nicht-Sicherungszweck wie Data Mining erstellt wird.
`VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT` Wert: 0x1000000 Ist für das System reserviert. Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 unterstützt.
`VSS_VOLSNAP_ATTR_TXF_RECOVERY` Wert: 0x2000000 Gibt an, dass die TxF-Wiederherstellung während der Erstellung von Schattenkopien erzwungen werden soll. Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 unterstützt.
`VSS_VOLSNAP_ATTR_FILE_SHARE` Wert: 0x4000000

Hinweise

Der Standardkontext für VSS-Schattenkopien ist VSS_CTX_BACKUP.

Ein Anforderer legt den Kontext für eine Schattenkopie fest, die erstellt werden soll, indem der Member der _VSS_SNAPSHOT_CONTEXT-Enumeration an die IVssBackupComponents::SetContext-Methode übergeben wird.

Anforderer können diesen Kontext ändern, indem sie ein bitweises OR des _VSS_SNAPSHOT_CONTEXT-Werts mit einem unterstützten Wert aus der _VSS_VOLUME_SNAPSHOT_ATTRIBUTES-Enumeration als Argument für IVssBackupComponents::SetContext verwenden.

Sofern nicht ausdrücklich zur Unterstützung eines bestimmten Mechanismus angefordert, können Anbieter jede Art von Mechanismus verwenden, um eine Schattenkopie zu implementieren. Wenn keine Schattenkopiemethode angegeben ist, kann der Anbieter daher einen differenziellen Mechanismus (VSS_VOLSNAP_ATTR_DIFFERENTIAL), einen PLEX-Mechanismus (VSS_VOLSNAP_ATTR_PLEX) oder einen anderen Mechanismus zur Unterstützung der Schattenkopie auswählen.

Obwohl ein Anbieter beide Mechanismen unterstützen kann, schließen sie sich für eine bestimmte Schattenkopie gegenseitig aus. Anforderer sollten nicht sowohl VSS_VOLSNAP_ATTR_DIFFERENTIAL als auch VSS_VOLSNAP_ATTR_PLEX verwenden, um einen bestimmten Schattenkopiekontext zu ändern.

Derzeit sind VSS_VOLSNAP_ATTR_DIFFERENTIAL, VSS_VOLSNAP_ATTR_PLEX und VSS_VOLSNAP_ATTR_TRANSPORTABLE die einzigen Werte der _VSS_VOLUME_SNAPSHOT_ATTRIBUTES-Enumeration , die zum Ändern eines beliebigen Kontexts verwendet werden können.

Darüber hinaus kann er nicht verwendet werden, um einen VSS_CTX_CLIENT_ACCESSIBLE Kontext zu ändern.

Ein Anforderer kann Informationen zu einer bestimmten Schattenkopie (identifiziert durch VSS_ID) abrufen, indem er die VSS_SNAPSHOT_PROP-Struktur aus der VSS_OBJECT_PROP-Struktur entpackt, die durch einen Aufruf von IVssBackupComponents::GetSnapshotProperties zurückgegeben wird.

Ein Anforderer kann auch eine VSS_SNAPSHOT_PROP-Struktur für jede von mehreren Schattenkopien abrufen, indem er IVssBackupComponents::Query aufruft und IVssEnumObject verwendet, um die Rückgaben zu durchlaufen.

Der Kontext und die Attribute der Schattenkopien werden als Bitmaske gefunden, die im m_lSnapshotAttributes-Element der VSS_SNAPSHOT_PROP-Struktur enthalten ist.

Anforderungen


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