IVssComponentEx：：SetPrepareForBackupFailureMsg 方法 (vswriter.h)

設定元件的 PrepareForBackup 失敗訊息字串。

這個方法只能由寫入器的 CVssWriter：：OnPrepareBackup 方法呼叫。

語法

HRESULT SetPrepareForBackupFailureMsg(
  [in] LPCWSTR wszFailureMsg
);

[in] wszFailureMsg

呼叫端配置的 Null 終止寬字元字串位址，其中包含描述處理 PrepareForBackup 事件時發生的錯誤失敗訊息。

以下是這個方法的有效傳回碼。

值	意義
S_OK	已成功設定失敗訊息。
E_INVALIDARG	其中一個參數值無效。
E_OUTOFMEMORY	呼叫端記憶體不足或其他系統資源。
VSS_E_BAD_STATE	這個方法不是由寫入器的 CVssWriter：：OnPrepareBackup 方法呼叫。

SetPrepareForBackupFailureMsg所設定的失敗訊息會套用至元件中的所有檔案和任何子元件。