CVssWriter-Klasse (vswriter.h)
Die CVssWriter-Klasse ist eine abstrakte Basisklasse, die die Schnittstelle definiert, mit der ein Writer seinen Zustand mit VSS und anderen Writern synchronisiert.
Jeder Writer muss ein von CVssWriter abgeleitetes Objekt instanziieren.
Von CVssWriter abgeleitete Objekte müssen Implementierungen für alle reinen virtuellen Methoden des CVssWriter bereitstellen.
Ein Writer kann eine oder alle virtuellen Methoden von CVssWriter überschreiben.
Um an VSS teilzunehmen, muss ein Writer zuerst CVssWriter::Initialize und dann CVssWriter::Subscribe aufrufen.
Ein Writer beendet seine Teilnahme, indem er CVssWriter::Unsubscribe aufruft.
Die CVssWriter-Basisklasse ist für den Lebenszyklus von Schnittstellen verantwortlich, die an Ereignishandler übergeben werden. Hierzu gehören folgende Elemente:
- Die instance der IVssWriterComponents-Schnittstelle, die an Folgendes übergeben wird: CVssWriter::OnPrepareBackup
- Die instance der IVssCreateWriterMetadata-Schnittstelle, die an CVssWriter::OnIdentify übergeben wird.
Methoden
Die CVssWriter-Klasse verfügt über diese Methoden.
| CVssWriter::~CVssWriter ~CVssWriter ist der Destruktor des CVssWriter-Klassenobjekts. |
| CVssWriter::AreComponentsSelected Die AreComponentsSelected-Methode gibt an, ob ein Anforderer im Komponentenmodus ausgeführt wird, und unterstützt die Auswahl einzelner zu sichernder Komponenten oder sichert ganze Volumes. |
| CVssWriter::CVssWriter CVssWriter ist der Konstruktor des CVssWriter-Klassenobjekts. |
| CVssWriter::GetBackupType Die GetBackupType-Methode gibt den Typ der auszuführenden Sicherung an. |
| CVssWriter::GetContext Die GetContext-Informationen geben den aktuellen Kontext für alle laufenden oder möglichen Schattenkopien zurück. |
| CVssWriter::GetCurrentLevel Die GetCurrentLevel-Methode gibt die aktuelle Anwendungsebene zurück. |
| CVssWriter::GetCurrentSnapshotSetId Die GetCurrentSnapshotSetId-Methode gibt den eindeutigen Bezeichner des Schattenkopiensatzes zurück. |
| CVssWriter::GetCurrentVolumeArray Die GetCurrentVolumeArray-Methode gibt die Namen der ursprünglichen Volumes und der UNC-Pfade der ursprünglichen Remotedateifreigaben zurück, die zum Schattenkopiesatz gehören, als Array von breit Zeichenfolgen, die null enden. Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP und Windows Server 2003: Remotedateifreigaben werden erst unterstützt, wenn Windows 8 und Windows Server 2012. |
| CVssWriter::GetCurrentVolumeCount Die GetCurrentVolumeCount-Methode gibt die Anzahl der Volumes im Schattenkopiensatz zurück. |
| CVssWriter::GetRestoreType Die GetRestoreType-Methode gibt den Wiederherstellungstyp zurück, an dem ein Writer beteiligt ist. |
| CVssWriter::GetSnapshotDeviceName Die GetSnapshotDeviceName-Methode gibt den Namen des Geräts zurück, das die Schattenkopie des angegebenen Volumes oder der angegebenen Dateifreigabe hostet. |
| CVssWriter::Initialize Initialisiert ein CVssWriter-Objekt und ermöglicht es einer Writer-Anwendung, mit VSS zu interagieren. |
| CVssWriter::InstallAlternateWriter Wird nicht unterstützt. (CVssWriter.InstallAlternateWriter) |
| CVssWriter::IsBootableSystemStateBackedUp Die IsBootableSystemStateBackedUp-Methode gibt an, ob der startbare Zustand gesichert wird. |
| CVssWriter::IsPartialFileSupportEnabled Die IsPartialFileSupportEnabled-Methode bestimmt, ob die partielle Dateiunterstützung aktiviert oder deaktiviert ist. |
| CVssWriter::IsPathAffected Die IsPathAffected-Methode bestimmt, ob das angegebene Verzeichnis oder die angegebene Datei im aktuellen Schattenkopiesatz enthalten ist. Der Pfad für das Verzeichnis oder die Datei kann ein lokaler Pfad oder ein UNC-Pfad einer Remotedateifreigabe sein. |
| CVssWriter::OnAbort Die OnAbort-Methode wird von einem Writer nach einem von VSS ausgegebenen Abort-Ereignis aufgerufen, das angibt, dass ein Schattenkopievorgang vorzeitig beendet wurde. Der Writer verwendet diese Methode, um den Versuch, an diesem Vorgang teilzunehmen, sauber. |
| CVssWriter::OnBackOffIOOnVolume Wird nicht unterstützt. (CVssWriter.OnBackOffIOOnVolume) |
| CVssWriter::OnBackupComplete Die OnBackupComplete-Methode wird von einem Writer nach einem BackupComplete-Ereignis aufgerufen. Es wird verwendet, um Vorgänge auszuführen, die nach einer Sicherung als notwendig erachtet werden. Diese Vorgänge können jedoch das Dokument sicherungskomponenten nicht ändern. |
| CVssWriter::OnBackupShutdown Die OnBackupShutdown-Methode wird von einem Writer nach einem BackupShutdown-Ereignis aufgerufen. Es wird verwendet, um Vorgänge auszuführen, die als notwendig angesehen werden, wenn eine Sicherungsanwendung heruntergefahren wird, insbesondere im Falle eines Absturzes der Sicherungsanwendung. |
| CVssWriter::OnContinueIOOnVolume Wird nicht unterstützt. (CVssWriter.OnContinueIOOnVolume) |
| CVssWriter::OnFreeze Die OnFreeze-Methode wird von einem Writer aufgerufen, wenn ein Freeze-Ereignis zu Beginn eines Fixierungsvorgangs für Schattenkopien empfangen wird. Ein Writer verwendet diese Methode, um Vorgänge auszuführen, die erforderlich sind, um am Einfrieren teilzunehmen oder ein Veto gegen das Einfrieren durchzuführen. |
| CVssWriter::OnIdentify Die OnIdentify-Methode wird von einem Writer aufgerufen, nachdem ein Identify-Ereignis empfangen wurde. |
| CVssWriter::OnPostRestore Die OnPostRestore-Methode wird von einem Writer nach einem PostRestore-Ereignis aufgerufen. Es wird verwendet, um Vorgänge auszuführen, die als notwendig erachtet werden, nachdem Dateien von einem Anforderer auf dem Datenträger wiederhergestellt wurden. Diese Vorgänge können jedoch das Dokument sicherungskomponenten nicht ändern. |
| CVssWriter::OnPostSnapshot Die OnPostSnapshot-Methode wird von einem Writer nach einem PostSnapshot-Ereignis aufgerufen. |
| CVssWriter::OnPrepareBackup Die OnPrepareBackup-Methode wird von einem Writer nach einem PrepareForBackup-Ereignis aufgerufen. Diese Methode wird verwendet, um den Zustand eines Writers und seine Komponenten zur Vorbereitung eines Sicherungsvorgangs zu konfigurieren. |
| CVssWriter::OnPrepareSnapshot Die OnPrepareSnapshot-Methode wird von einem Writer aufgerufen, um ein PrepareForSnapshot-Ereignis zu behandeln. Es wird verwendet, um Vorgänge auszuführen, die erforderlich sind, um einen Writer auf die Teilnahme an der Schattenkopie vorzubereiten oder ein Veto gegen eine Schattenkopie durchzuführen. |
| CVssWriter::OnPreRestore Die OnPreRestore-Methode wird von einem Writer nach einem PreRestore-Ereignis aufgerufen. |
| CVssWriter::OnThaw Die OnThaw-Methode wird von einem Writer nach einem Thaw-Ereignis aufgerufen. |
| CVssWriter::OnVSSApplicationStartup Wird nicht unterstützt. (CVssWriter.OnVSSApplicationStartup) |
| CVssWriter::OnVSSShutdown Wird nicht unterstützt. (CVssWriter.OnVssShutdown) |
| CVssWriter::SetWriterFailure Die SetWriterFailure-Methode gibt an, dass für diesen Writer eine Fehlerbedingung aufgetreten ist, und legt eine Fehlerbedingung fest. |
| CVssWriter::Subscribe Die Subscribe-Methode abonniert den Writer mit VSS. |
| CVssWriter::Unsubscribe Mit der Unsubscribe-Methode wird der Writer mit VSS abbestellt. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vswriter.h (enthalten Vss.h, VsWriter.h) |