CVssWriterEx2：：SetWriterFailureEx 方法 (vswriter.h)

设置扩展的错误信息，以指示编写器在参与 VSS 操作时遇到了问题。

语法

HRESULT SetWriterFailureEx(
  [in] HRESULT hrWriter,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage
);

[in] hrWriter

要返回给请求者的错误代码。

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

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

[in] hrApplication

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

[in] wszApplicationMessage

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

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

若要报告组件级错误，编写器应使用 IVssComponentEx2：：SetFailure 方法。

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