Freigeben über


IVssComponentEx::GetPostSnapshotFailureMsg-Methode (vswriter.h)

Gibt die PostSnapshot-Fehlermeldungszeichenfolge zurück, die ein Writer für eine bestimmte Komponente festgelegt hat.

Sowohl Autoren als auch Anforderer können diese Methode aufrufen. Writer sollten diese Methode aufrufen, nachdem der asynchrone Vorgang IVssBackupComponents::D oSnapshotSet abgeschlossen wurde.

Syntax

HRESULT GetPostSnapshotFailureMsg(
  [out] BSTR *pbstrFailureMsg
);

Parameter

[out] pbstrFailureMsg

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge mit der Fehlermeldung, die einen Fehler beschreibt, der beim Verarbeiten eines PostSnapshot-Ereignisses aufgetreten ist.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert Bedeutung
S_OK
Die Fehlermeldung wurde erfolgreich abgerufen.
S_FALSE
Für die Komponente wurde keine PostSnapshot-Fehlermeldung festgelegt.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.

Hinweise

Der Aufrufer ist für das Freigeben der Zeichenfolge verantwortlich, auf die der pbstrFailureMsg-Parameter verweist, indem er die SysFreeString-Funktion aufruft.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vswriter.h (einschließlich Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

CVssWriter::OnPostSnapshot

IVssComponentEx

IVssComponentEx::SetPostSnapshotFailureMsg