IVssComponentEx::GetPostSnapshotFailureMsg 方法 (vswriter.h)

返回编写器为给定组件设置的 PostSnapshot 失败消息字符串。

编写者和请求者都可以调用此方法。 编写器应在 IVssBackupComponents::D oSnapshotSet 异步操作完成后调用此方法。

语法

HRESULT GetPostSnapshotFailureMsg(
  [out] BSTR *pbstrFailureMsg
);

参数

[out] pbstrFailureMsg

指向以 null 结尾的宽字符串的指针,其中包含描述处理 PostSnapshot 事件时发生的错误的失败消息。

返回值

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

含义
S_OK
已成功获取失败消息。
S_FALSE
未为组件设置 PostSnapshot 失败消息。
E_INVALIDARG
其中一个参数值无效。
E_OUTOFMEMORY
调用方内存不足或其他系统资源。

注解

调用方负责通过调用 SysFreeString 函数释放 pbstrFailureMsg 参数指向的字符串。

要求

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

另请参阅

CVssWriter::OnPostSnapshot

IVssComponentEx

IVssComponentEx::SetPostSnapshotFailureMsg