IVssBackupComponents::BackupComplete-Methode (vsbackup.h)

Artikel
08/27/2023

Die BackupComplete-Methode bewirkt, dass VSS ein BackupComplete-Ereignis generiert, das Autoren signalisiert, dass der Sicherungsvorgang abgeschlossen wurde.

Syntax

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

Parameter

[out] ppAsync

Doppelt indirekter Zeiger auf eine IVssAsync-instance.

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 gültigen Werte, die vom pHrResult-Parameter zurückgegeben werden, 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.
VSS_E_UNEXPECTED_WRITER_ERROR	Während der Kommunikation mit Autoren ist ein unerwarteter Fehler aufgetreten. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

Hinweise

Beim Arbeiten im Komponentenmodus (IVssBackupComponents::SetBackupState wurde mit dem Argument TRUE für ausgewählte Komponenten aufgerufen), können Autoren den Erfolg oder Fehler der Sicherung einer komponente ermitteln, die explizit in den Dokumentkomponenten der Sicherungskomponenten enthalten ist, indem sie IVssComponent::GetBackupSucceeded verwenden. Daher muss eine gut erzogene Sicherungsanwendung (Anforderer) IVssBackupComponents::SetBackupSucceeded aufrufen , nachdem jede Komponente verarbeitet wurde und vor dem Aufrufen von BackupComplete.

Rufen Sie diese Methode nicht auf, wenn der Aufruf von IVssBackupComponents::D oSnapshotSet fehlgeschlagen ist. Weitere Informationen zur Verwendung von DoSnapshotSet, SetBackupSucceeded und BackupComplete in einem Sicherungsvorgang finden Sie unter Übersicht über Pre-Backup-Aufgaben und Übersicht über die tatsächliche Sicherung von Dateien.

Dieser Vorgang ist asynchron. Der Aufrufer kann die QueryStatus-Schnittstellenmethode in der zurückgegebenen IVssAsync-Schnittstelle verwenden, um die status der Benachrichtigung zu bestimmen.

Nach dem Aufruf von BackupComplete müssen Die Anforderer GatherWriterStatus aufrufen, damit die Writersitzung auf den Status abgeschlossen festgelegt wird.

Hinweis Dies ist nur unter Windows Server 2008 mit Service Pack 2 (SP2) und früher erforderlich.

Die Sicherungsanwendung kann die Sicherung jederzeit abbrechen, nachdem die Schattenkopie erstellt wurde, indem IVssAsync::Cancel aufgerufen wird.

Die aufrufende Anwendung ist dafür verantwortlich, IUnknown::Release aufzurufen, um die ressourcen des zurückgegebenen IVssAsync freizugeben, wenn sie nicht mehr benötigt wird.

Anforderungen


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