Freigeben über


IVssComponentEx::SetPrepareForBackupFailureMsg-Methode (vswriter.h)

Legt eine PrepareForBackup-Fehlermeldungszeichenfolge für eine Komponente fest.

Diese Methode kann nur von der CVssWriter::OnPrepareBackup-Methode eines Writers aufgerufen werden.

Syntax

HRESULT SetPrepareForBackupFailureMsg(
  [in] LPCWSTR wszFailureMsg
);

Parameter

[in] wszFailureMsg

Die Adresse einer vom Aufrufer zugeordneten NULL-beendeten Breitzeichenzeichenfolge, die die Fehlermeldung enthält, die einen Fehler beschreibt, der bei der Verarbeitung eines PrepareForBackup-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
Diese Methode wurde nicht von der CVssWriter::OnPrepareBackup-Methode eines Writers aufgerufen.

Hinweise

Die von SetPrepareForBackupFailureMsg festgelegte Fehlermeldung gilt für alle Dateien in der Komponente und alle Unterkomponenten.

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

Weitere Informationen

CVssWriter::OnPrepareBackup

IVssComponentEx

IVssComponentEx::GetPrepareForBackupFailureMsg