IVssComponent::SetPreRestoreFailureMsg-Methode (vswriter.h)

Die SetPreRestoreFailureMsg-Methode wird verwendet, um eine Meldung zu erstellen, die einen Fehler bei der Verarbeitung eines PreRestore-Ereignisses beschreibt.

Nur ein Writer kann diese Methode aufrufen, und zwar nur während eines Wiederherstellungsvorgangs.

Syntax

HRESULT SetPreRestoreFailureMsg(
  [in] LPCWSTR wszPreRestoreFailureMsg
);

Parameter

[in] wszPreRestoreFailureMsg

Eine vom Aufrufer zugeordnete NULL-beendete Breitzeichenzeichenfolge, die die Fehlermeldung enthält, die einen Fehler beschreibt, der bei der Verarbeitung eines PreRestore-Ereignisses aufgetreten ist.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
Die Fehlermeldung wurde erfolgreich festgelegt.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE
Der Aufrufer befindet sich nicht im richtigen Zustand (Sicherung oder Wiederherstellung) für den Vorgang.

Hinweise

Die von SetPreRestoreFailureMsg festgelegte Fehlermeldung gilt für alle Dateien in der Komponente und alle nicht auswählbaren Unterkomponenten.

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 (enthalten Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssComponent

IVssComponent::GetPostRestoreFailureMsg

IVssComponent::GetPreRestoreFailureMsg

IVssComponent::SetPostRestoreFailureMsg