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 慣例來指定寫入器的主要和次要版本號碼：

• 每當發行的寫入器版本包含影響寫入器與要求者的互動時，寫入器的次要版本號碼應該遞增一個。 例如，寫入器 QFE 或 Service Pack 中檔案規格的修正會證明遞增次要版本號碼。 不過，在 Beta 版或發行候選版的寫入器版本之間變更，並不會證明變更次要版本號碼。
• 每當發行的寫入器版本包含重大變更時，寫入器的主要版本號碼應該遞增一個。 例如，如果使用舊版寫入器還原以新版寫入器備份的數據，則新寫入器的主要版本號碼應該遞增。
• 每當主要版本號碼遞增時，次要版本號碼應該重設為零。

如果寫入器未指定版本號碼，VSS 會指派預設版本號碼 0.0。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台	Windows
標頭	vswriter.h

另請參閱

CreateVssExpressWriter

IVssExpressWriter