CreateVssExamineWriterMetadataInternal 函数 (vsbackup.h)

CreateVssExamineWriterMetadata 函数创建 IVssExamineWriterMetadata 对象。

注意此函数导出为 CreateVssExamineWriterMetadataInternal，但应调用 CreateVssExamineWriterMetadata，而不是 CreateVssExamineWriterMetadataInternal。

语法

HRESULT CreateVssExamineWriterMetadataInternal(
  [in]  BSTR                      bstrXML,
  [out] IVssExamineWriterMetadata **ppMetadata
);

[in] bstrXML

包含用于初始化返回的 IVssExamineWriterMetadata 对象的编写器元数据文档的 XML 字符串。

[out] ppMetadata

一个变量，用于接收指向对象的 IVssExamineWriterMetadata 接口指针。

此处列出的返回值是可能随时从函数返回的正常 COM HRESULT 的补充。

值	含义
S_OK	已成功返回指向 IVssExamineWriterMetadata 接口的指针。
E_ACCESSDENIED	调用方没有足够的备份权限或不是管理员。
E_INVALIDARG	其中一个参数无效。
E_OUTOFMEMORY	内存不足或其他系统资源。
VSS_E_INVALID_XML_DOCUMENT	在 bstrXML 参数中传递的 XML 文档无效，也就是说，它不是格式正确的 XML 字符串，或者它与架构不匹配。
VSS_E_UNEXPECTED	意外错误。错误代码记录在错误日志文件中。有关详细信息，请参阅 VSS 下的事件和错误处理。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：在 Windows Server 2008 R2 和 Windows 7 之前，不支持此值。改用E_UNEXPECTED。

若要将编写器的编写器元数据文档的副本保存到 XML 字符串中以传入 bstrXML 参数，请使用 IVssExamineWriterMetadata：：SaveAsXML 方法。

若要检索最新版本的编写器元数据文档，请使用 IVssBackupComponents：：GetWriterMetadata 方法。

若要将编写器元数据文档加载到现有 IVssExamineWriterMetadata 对象中，请使用 IVssExamineWriterMetadata：：LoadFromXML 方法。

用户不应尝试修改编写器元数据文档的内容。

调用应用程序负责调用 IUnknown：：Release ，以便在不再需要该对象时释放 IVssExamineWriterMetadata 对象保留的资源。

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