iVssComponentEx2::SetFailure 方法 (vswriter.h)

VSS 编写器调用此方法以报告组件级别的错误。

语法

HRESULT SetFailure(
  [in] HRESULT hr,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage,
  [in] DWORD   dwReserved
);

参数

[in] hr

要返回给调用 IVssComponentEx2::GetFailure 方法的请求者的错误代码。

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

含义
S_OK
编写器成功。
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
卷影副本仅包含编写器正确备份应用程序组件所需的卷子集。
VSS_E_WRITERERROR_OUTOFRESOURCES
编写器耗尽了内存或其他系统资源。 处理此错误代码的建议方法是等待十分钟,然后重复该操作,最多三次。
VSS_E_WRITERERROR_TIMEOUT
由于冻结和解冻事件之间超时,编写器操作失败。 处理此错误代码的建议方法是等待十分钟,然后重复该操作,最多三次。
VSS_E_WRITERERROR_RETRYABLE
编写器失败,因为如果重新启动整个备份、还原或卷影副本创建过程,则可能不会发生错误。 处理此错误代码的建议方法是等待十分钟,然后重复该操作,最多三次。
VSS_E_WRITERERROR_NONRETRYABLE
编写器操作失败,因为如果创建了另一个卷影副本,可能会重复出现错误。 有关详细信息,请参阅 VSS 下的事件和错误处理

[in] hrApplication

要返回给请求者的其他错误代码。 此参数是可选的。

[in] wszApplicationMessage

包含要向最终用户显示请求者的错误消息的字符串。 如有必要,编写器负责本地化此字符串,然后再在此方法中使用它。 此参数是可选的,可为 NULL 或空字符串。

[in] dwReserved

此参数保留供将来使用,应设置为零。

返回值

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

注解

除了调用此方法之外,还可以使用 CVssWriterEx2::SetWriterFailureEx 方法报告发生了部分编写器故障。

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

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 vswriter.h

另请参阅

IVssComponentEx2