IVssComponent::GetPreRestoreFailureMsg-Methode (vswriter.h)
Die GetPreRestoreFailureMsg-Methode ruft die von einem Writer generierte Fehlermeldung ab, während das PreRestore-Ereignis behandelt wird, wenn IVssComponent::SetPreRestoreFailureMsg einen Wert festgelegt hat.
Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.
Syntax
HRESULT GetPreRestoreFailureMsg(
[out] BSTR *pbstrPreRestoreFailureMsg
);
Parameter
[out] pbstrPreRestoreFailureMsg
Zeichenfolge mit der Fehlermeldung, die einen Fehler beschreibt, der bei der Verarbeitung des PreRestore-Ereignisses aufgetreten ist.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Attributwert wurde erfolgreich zurückgegeben. |
|
Es war keine PreRestore-Fehlermeldung zum Abrufen verfügbar. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
Hinweise
Der Aufrufer sollte den Arbeitsspeicher des pbstrPreRestoreFailureMsg-Parameters durch Aufrufen von SysFreeString freigeben.
Wenn SetPreRestoreFailureMsg nicht zum Festlegen einer PreRestore-Fehlermeldung verwendet wurde, gibt GetPreRestoreFailureMsg S_FALSE zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vswriter.h (einschließlich Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssComponent::GetPostRestoreFailureMsg