CVssWriter::SetWriterFailure 方法 (vswriter.h)

SetWriterFailure 方法指示此编写器遇到错误条件并设置错误条件。

SetWriterFailure 是由 CVssWriter 基类实现的受保护方法。

语法

HRESULT SetWriterFailure(
  [in] HRESULT hr
);

参数

[in] hr

要设置的错误代码。 以下是此方法可以设置的错误代码。

含义
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
卷影副本仅包含正确备份应用程序组件所需的卷子集。
VSS_E_WRITERERROR_NONRETRYABLE
由于创建另一个卷影副本时可能发生的错误,编写器失败。
VSS_E_WRITERERROR_OUTOFRESOURCES
由于资源分配错误,编写器失败。
VSS_E_WRITERERROR_RETRYABLE
编写器失败,因为如果重新启动整个备份、还原或卷影副本创建过程,则可能不会发生错误。
VSS_E_WRITERERROR_TIMEOUT
编写器无法完成卷影副本创建,因为冻结和解冻状态之间的时间超过了在 CVssWriter::Initialize 中设置 (的 dwTimeoutFreeze) 超时值。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

无法从 CVssWriter::OnIdentifyCVssWriterEx::OnIdentifyEx 调用此方法。

如果编写器的事件处理程序 ((如 CVssWriter::OnFreeze) 调用此方法),则必须在调用事件处理程序的同一线程中执行此操作。 有关详细信息,请参阅 编写器事件处理

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 vswriter.h (包括 Vss.h、VsWriter.h)
Library VssApi.lib

另请参阅

CVssWriter

IVssBackupComponents::GetWriterStatus