CVssWriterEx2::SetWriterFailureEx-Methode (vswriter.h)

Artikel
03/06/2024

Legt erweiterte Fehlerinformationen fest, um anzugeben, dass beim Writer ein Problem mit der Teilnahme an einem VSS-Vorgang aufgetreten ist.

Syntax

HRESULT SetWriterFailureEx(
  [in] HRESULT hrWriter,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage
);

Parameter

[in] hrWriter

Der Fehlercode, der an den Anforderer zurückgegeben werden soll.

Im Folgenden finden Sie die Fehlercodes, die diese Methode festlegen kann.

Wert	Bedeutung
S_OK	Der Schreiber war erfolgreich.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	Die Schattenkopie enthält nur eine Teilmenge der Volumes, die der Writer benötigt, um die Anwendungskomponente ordnungsgemäß zu sichern.
VSS_E_WRITERERROR_OUTOFRESOURCES	Dem Writer ist der Arbeitsspeicher oder andere Systemressourcen nicht mehr verfügbar. Die empfohlene Möglichkeit, diesen Fehlercode zu behandeln, besteht darin, zehn Minuten zu warten und den Vorgang dann bis zu dreimal zu wiederholen.
VSS_E_WRITERERROR_TIMEOUT	Der Writer-Vorgang ist aufgrund eines Timeouts zwischen den Freeze- und Thaw-Ereignissen fehlgeschlagen. Die empfohlene Möglichkeit, diesen Fehlercode zu behandeln, besteht darin, zehn Minuten zu warten und den Vorgang dann bis zu dreimal zu wiederholen.
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. Die empfohlene Möglichkeit, diesen Fehlercode zu behandeln, besteht darin, zehn Minuten zu warten und den Vorgang dann bis zu dreimal zu wiederholen.
VSS_E_WRITERERROR_NONRETRYABLE	Der Writervorgang ist aufgrund eines Fehlers fehlgeschlagen, der möglicherweise erneut auftritt, wenn eine weitere Schattenkopie erstellt wird. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_WRITERERROR_PARTIAL_FAILURE	Der Writer meldet mindestens einen Fehler auf Komponentenebene. Um die Fehler zu melden, muss der Writer die IVssComponentEx2::SetFailure-Methode verwenden.

[in] hrApplication

Ein zusätzlicher Fehlercode, der an den Anforderer zurückgegeben werden soll. Dieser Parameter ist optional.

[in] wszApplicationMessage

Eine Zeichenfolge, die eine Fehlermeldung für den Anforderer enthält, die dem Endbenutzer angezeigt werden soll. Der Writer ist für die Lokalisierung dieser Zeichenfolge verantwortlich, falls erforderlich, bevor sie in dieser Methode verwendet wird. Dieser Parameter ist optional und kann NULL oder eine leere Zeichenfolge sein.

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.

Um Fehler auf Komponentenebene zu melden, sollten Writer die IVssComponentEx2::SetFailure-Methode verwenden.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

CVssWriter::SetWriterFailure

CVssWriterEx2

IVssBackupComponentsEx3::GetWriterStatusEx

Freigeben über