IVssComponentEx2::SetFailure-Methode (vswriter.h)
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 |
|---|---|
|
Der Autor war erfolgreich. |
|
Die Schattenkopie enthält nur eine Teilmenge der Volumes, die der Writer benötigt, um die Anwendungskomponente ordnungsgemäß zu sichern. |
|
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. |
|
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. |
|
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. |
|
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 |