IVssBackupComponents::P repareForBackup-Methode (vsbackup.h)

Artikel
03/03/2024

Die PrepareForBackup-Methode führt dazu, dass VSS ein PrepareForBackup-Ereignis generiert, das Autoren signalisiert, sich auf einen bevorstehenden Sicherungsvorgang vorzubereiten. Dadurch wird das Dokument der Sicherungskomponenten eines Anforderers für Autoren verfügbar.

Syntax

HRESULT PrepareForBackup(
  [out] IVssAsync **ppAsync
);

Parameter

[out] ppAsync

Doppelt indirekter Zeiger auf eine instance der IVssAsync-Schnittstelle, die verwendet wird, um zu bestimmen, wann der asynchrone Vorgang abgeschlossen ist.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert	Bedeutung
S_OK	Es wurde erfolgreich ein Zeiger auf eine instance der IVssAsync-Schnittstelle zurückgegeben. Die im pHrResult-Parameter zurückgegebenen Fehlercodes finden Sie unter IVssAsync::QueryStatus.
E_INVALIDARG	ppAsync zeigt nicht auf einen gültigen Zeiger. Das heißt, es ist NULL.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen.
VSS_E_UNEXPECTED	Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

PrepareForBackup generiert ein PrepareForBackup-Ereignis, das von jedem instance jedes Writers über die CVssWriter::OnPrepareBackup-Methode behandelt wird.

Bevor PrepareForBackup aufgerufen werden kann, muss IVssBackupComponents::SetBackupState aufgerufen werden.

Das Dokument der Sicherungskomponenten kann weiterhin von Autoren in ihrem PrepareForBackup-Ereignishandler (CVssWriter::OnPrepareBackup) und danach bis zur Generierung eines BackupComplete-Ereignisses geändert werden.

Der Aufrufer ist für die Freigabe der IVssAsync-Schnittstelle verantwortlich.

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	vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h)
Bibliothek	VssApi.lib