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 方法报告发生了部分编写器故障。