IVssComponentEx2::GetFailure-Methode (vswriter.h)
VSS-Anforderer rufen diese Methode auf, um von Writern gemeldete Fehler auf Komponentenebene abzurufen.
Syntax
HRESULT GetFailure(
[out] HRESULT *phr,
[out] HRESULT *phrApplication,
[out] BSTR *pbstrApplicationMessage,
[out] DWORD *pdwReserved
);
Parameter
[out] phr
Die Adresse einer vom Aufrufer zugeordneten Variablen, die den HRESULT-Fehlercode empfängt, den der Writer für den hr-Parameter der IVssComponentEx2::SetFailure-Methode übergeben hat. Dieser Parameter ist erforderlich und darf nicht NULL sein.
Im Folgenden werden die unterstützten Werte aufgeführt.
| 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 reagiert nicht. |
|
Die Writer-status ist für mindestens einen Writer nicht verfügbar. Ein Writer hat möglicherweise die maximale Anzahl verfügbarer Sicherungs- und Wiederherstellungssitzungen erreicht. |
[out] phrApplication
Die Adresse einer vom Aufrufer zugeordneten Variablen, die den Rückgabecode empfängt, den der Writer für den hrApplication-Parameter der SetFailure-Methode übergeben hat. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] pbstrApplicationMessage
Die Adresse einer vom Aufrufer zugeordneten Variablen, die die Anwendungsfehlermeldung empfängt, die der Writer für den wszApplicationMessage-Parameter der SetFailure-Methode übergeben hat. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] pdwReserved
Die Adresse einer vom Aufrufer zugeordneten DWORD-Variablen. Dieser Parameter ist für die zukünftige Verwendung reserviert, aber er ist erforderlich und darf nicht NULL sein.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Die status des angegebenen Writer wurde erfolgreich zurückgegeben. Beachten Sie, dass der Wert des parameters phrFailureWriter überprüft werden muss, um zu überprüfen, ob der Writer erfolgreich war. Die Writerfehlercodes können zu den in VsWriter.h und in Writerfehlern und Vetoes aufgeführten Gehören. |
|
Der Parameter phr, phrApplication, pbstrApplicationMessage oder pdwReserved ist NULL. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
Hinweise
Wenn der Aufrufer den Zugriff auf die von dieser Methode zurückgegebenen status Informationen abgeschlossen hat, sollte er SysFreeString aufrufen, um den Arbeitsspeicher freizugeben, der vom pbstrApplicationMessage-Parameter gespeichert ist.
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 |