IVssComponentEx2::SetFailure-Methode (vswriter.h)

Artikel
08/27/2023

VSS-Autoren rufen diese Methode auf, um Fehler auf Komponentenebene zu melden.

Syntax

HRESULT SetFailure(
  [in] HRESULT hr,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage,
  [in] DWORD   dwReserved
);

Parameter

[in] hr

Der Fehlercode, der an den Anforderer zurückgegeben werden soll, der die IVssComponentEx2::GetFailure-Methode aufruft.

Im Folgenden sind die Fehlercodes aufgeführt, die diese Methode festlegen kann.

Wert	Bedeutung
S_OK	Der Autor 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 ging der Arbeitsspeicher oder andere Systemressourcen aus. 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	Fehler beim Writer-Vorgang aufgrund eines Timeouts zwischen dem Freeze- und Thaw-Ereignis. 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 Sicherungs-, Wiederherstellungs- oder Schattenkopienerstellungsprozess 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 wiederholt wird, wenn eine weitere Schattenkopie erstellt wird. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

[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 bei Bedarf verantwortlich, bevor sie in dieser Methode verwendet wird. Dieser Parameter ist optional und kann NULL oder eine leere Zeichenfolge sein.

[in] dwReserved

Dieser Parameter ist für die zukünftige Verwendung reserviert und sollte auf null festgelegt werden.

Rückgabewert

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

Hinweise

Verwenden Sie zusätzlich zum Aufrufen dieser Methode die CVssWriterEx2::SetWriterFailureEx-Methode , um zu melden, dass ein teilweiser Schreibfehler aufgetreten ist.

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

Anforderungen


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

Weitere Informationen

IVssComponentEx2

Freigeben über