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