CVssWriter::GetContext-Methode (vswriter.h)

Die GetContext-Informationen geben den aktuellen Kontext für alle laufenden oder möglichen Schattenkopien zurück.

GetContext ist eine geschützte Methode, die von der CVssWriter-Basisklasse implementiert wird.

Syntax

LONG GetContext();

Rückgabewert

Diese Methode gibt den Kontext für alle Schattenkopien mit dem Writer als Bitmaske (oder bitweises OR) von _VSS_SNAPSHOT_CONTEXT - und _VSS_VOLUME_SNAPSHOT_ATTRIBUTES-Werten zurück.

Hinweise

Der Standardkontext für eine Schattenkopie ist VSS_CTX_BACKUP.

Ein Anforderer kann den Kontext für eine Schattenkopie festlegen, indem er IVssBackupComponents::SetContext jederzeit vor dem Erstellen einer Schattenkopie mit IVssBackupComponents::D oSnapshotSet aufruft.

IVssBackupComponents::D oSnapshotSet generiert eine Reihe von Ereignissen (PrepareForSnapshot, Freeze, Thaw, PostSnapshot), wobei das erste Ereignis PrepareForSnapshot ist.

Wenn ein Writer an einem Schattenkopievorgang teilnimmt, kann daher kein endgültiger Wert des Kontexts dieser Schattenkopie gefunden werden, wenn GetContext vor CVssWriter::OnPrepareSnapshot aufgerufen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

CVssWriter

CVssWriter::OnPrepareSnapshot

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::SetContext

_VSS_SNAPSHOT_CONTEXT

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES