IVssComponent::GetPostRestoreFailureMsg 方法 (vswriter.h)

如果 IVssComponent::SetPostRestoreFailureMsg 设置了一个,则 GetPostRestoreFailureMsg 方法返回编写器在处理 PostRestore 事件时生成的失败消息。

编写器或请求者可以调用此方法。

语法

HRESULT GetPostRestoreFailureMsg(
  [out] BSTR *pbstrPostRestoreFailureMsg
);

参数

[out] pbstrPostRestoreFailureMsg

指向包含失败消息的字符串的指针,该消息描述在处理 PostRestore 事件时发生的错误。

返回值

下面是此方法的有效返回代码。

含义
S_OK
已成功返回属性值。
S_FALSE
没有可用于检索的 PostRestoreFailure 消息。
E_INVALIDARG
其中一个参数值无效。
E_OUTOFMEMORY
调用方内存或其他系统资源不足。
VSS_E_INVALID_XML_DOCUMENT
XML 文档无效。 有关详细信息,请查看事件日志。 有关详细信息,请参阅 VSS 下的事件和错误处理

注解

调用方应通过调用 SysFreeString 来释放 pbstrPostRestoreFailureMsg 参数保留的内存。

如果未使用 SetPostRestoreFailureMsg 设置 PostRestore 失败消息, GetPreRestoreFailureMsg 将返回S_FALSE。

要求

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

另请参阅

IVssComponent

IVssComponent::GetPreRestoreFailureMsg

IVssComponent::SetPostRestoreFailureMsg

IVssComponent::SetPreRestoreFailureMsg