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