IVssBackupComponents::GatherWriterStatus-Methode (vsbackup.h)

  • Artikel

Die GatherWriterStatus-Methode fordert jeden Writer auf, eine status Nachricht zu senden.

Syntax

HRESULT GatherWriterStatus(
  [out] IVssAsync **pAsync
);

Parameter

[out] pAsync

Doppelt indirekter Zeiger auf ein IVssAsync-Objekt, das den Writer status Daten enthält.

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_ACCESSDENIED
 Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
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_WRITER_INFRASTRUCTURE
 Die Writer-Infrastruktur funktioniert nicht ordnungsgemäß. Überprüfen Sie, ob der Ereignisdienst und VSS gestartet wurden, und überprüfen Sie im Fehlerprotokoll auf Fehler, die diesen Diensten zugeordnet sind.

Hinweise

Der Aufrufer dieser Methode sollte auch IVssBackupComponents::FreeWriterStatus aufrufen, nachdem er die status jedes Writers erhalten hat.

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 CVssWriter-Klasse verarbeitet die status Nachricht, die von jedem Writer gesendet wird.

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

Weitere Informationen

CVssWriter

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::FreeWriterStatus