CVssWriter::SetWriterFailure-Methode (vswriter.h)

Die SetWriterFailure-Methode gibt an, dass für diesen Writer eine Fehlerbedingung aufgetreten ist, und legt eine Fehlerbedingung fest.

SetWriterFailure ist eine geschützte Methode, die von der CVssWriter-Basisklasse implementiert wird.

Syntax

HRESULT SetWriterFailure(
  [in] HRESULT hr
);

Parameter

[in] hr

Fehlercode, der festgelegt werden soll. Im Folgenden finden Sie die Fehlercodes, die diese Methode festlegen kann.

Wert Bedeutung
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
Die Schattenkopie enthält nur eine Teilmenge der Volumes, die zum ordnungsgemäßen Sichern einer Anwendungskomponente erforderlich sind.
VSS_E_WRITERERROR_NONRETRYABLE
Fehler beim Writer aufgrund eines Fehlers, der wahrscheinlich auftreten würde, wenn eine weitere Schattenkopie erstellt wird.
VSS_E_WRITERERROR_OUTOFRESOURCES
Fehler beim Writer aufgrund eines Ressourcenzuordnungsfehlers.
VSS_E_WRITERERROR_RETRYABLE
Fehler beim Writer aufgrund eines Fehlers, der wahrscheinlich nicht auftreten würde, wenn der gesamte Erstellungsprozess für Sicherung, Wiederherstellung oder Schattenkopie neu gestartet wurde.
VSS_E_WRITERERROR_TIMEOUT
Der Writer konnte die Erstellung der Schattenkopie nicht abschließen, da die Zeit zwischen dem Einfrieren und dem Tauzustand den in CVssWriter::Initialize festgelegten Timeoutwert (dwTimeoutFreeze) überstieg.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode kann nicht von CVssWriter::OnIdentify oder CVssWriterEx::OnIdentifyEx aufgerufen werden.

Wenn der Ereignishandler eines Writers (z. B . CVssWriter::OnFreeze) diese Methode aufruft, muss er dies im selben Thread tun, der den Ereignishandler aufgerufen hat. Weitere Informationen finden Sie unter Writer-Ereignisbehandlung.

Anforderungen

   
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)
Bibliothek VssApi.lib

Weitere Informationen

CVssWriter

IVssBackupComponents::GetWriterStatus