IVssExpressWriter：：CreateMetadata 方法 (vswriter.h)

创建快速编写器元数据对象，并返回指向它的 IVssCreateExpressWriterMetadata 接口指针。

语法

HRESULT CreateMetadata(
  [in]  VSS_ID                          writerId,
  [in]  LPCWSTR                         writerName,
  [in]  VSS_USAGE_TYPE                  usageType,
  [in]  DWORD                           versionMajor,
  [in]  DWORD                           versionMinor,
  [in]  DWORD                           reserved,
  [out] IVssCreateExpressWriterMetadata **ppMetadata
);

参数

[in] writerId

编写器类的全局唯一标识符 (GUID) 。

[in] writerName

一个以 null 结尾的宽字符串，其中包含编写器类的名称。 此字符串未本地化。

[in] usageType

VSS_USAGE_TYPE枚举值，该值指示如何在主机系统上使用编写器管理的数据。 此参数的唯一有效值为 VSS_UT_BOOTABLESYSTEMSTATE、VSS_UT_SYSTEMSERVICE 和 VSS_UT_USERDATA。

[in] versionMajor

编写器应用程序的主版本。 有关详细信息，请参见“备注”部分。

[in] versionMinor

编写器应用程序的次要版本。 有关详细信息，请参见“备注”部分。

[in] reserved

此参数保留供系统使用。

[out] ppMetadata

指向变量的指针，该变量接收指向新创建的快速编写器元数据的 IVssCreateExpressWriterMetadata 接口指针。

返回值

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

注解

versionMajor 和 versionMajor 参数用于根据以下 VSS 约定指定编写器的主要版本号和次要版本号：

• 每当编写器的已发布版本包含影响编写器与请求者的交互的次要更改时，编写器的次要版本号应递增 1。 例如，更正编写器 QFE 或 Service Pack 中的文件规范将证明递增次要版本号是正当的。 但是，编写器的 beta 版本或候选发布版本之间的更改并不能证明更改次要版本号是正当的。
• 每当编写器的已发布版本包含重大更改时，编写器的主版本号应按 1 递增。 例如，如果无法使用编写器的早期版本还原使用新版本编写器备份的数据，则新编写器的主版本号应递增。
• 每当主版本号递增时，次要版本号应重置为零。

如果编写器未指定版本号，VSS 将分配默认版本号 0.0。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	vswriter.h

另请参阅

CreateVssExpressWriter

IVssExpressWriter