IVssBackupComponents::GatherWriterStatus-Methode (vsbackup.h)
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 |
|---|---|
|
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. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
ppAsync zeigt nicht auf einen gültigen Zeiger. Das heißt, es ist NULL. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen. |
|
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. |
|
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.
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 |