Поделиться через


Метод IVssExpressWriter::CreateMetadata (vswriter.h)

Создает объект метаданных модуля записи express и возвращает указатель на интерфейс 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 на только что созданные метаданные модуля записи Express.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Параметры versionMajor и versionMajor используются для указания основного и дополнительного номеров версий модуля записи в соответствии со следующими соглашениями VSS:

  • Дополнительный номер версии модуля записи должен увеличиваться на единицу всякий раз, когда выпущенная версия модуля записи содержит незначительные изменения, влияющие на взаимодействие модуля записи с инициаторами запроса. Например, исправление спецификации файла в QFE модуля записи или пакете обновления оправдывает увеличение дополнительного номера версии. Однако изменение между бета-версиями или версиями-кандидатами модуля записи не оправдывает изменение дополнительного номера версии.
  • Основной номер версии модуля записи должен увеличиваться на единицу всякий раз, когда выпущенная версия модуля записи содержит значительные изменения. Например, если данные, резервные копии которых создаются с помощью новой версии модуля записи, не могут быть восстановлены с помощью предыдущей версии модуля записи, необходимо увеличить основной номер версии нового модуля записи.
  • Всякий раз, когда основной номер версии увеличивается, дополнительный номер версии следует сбросить до нуля.
Если модуль записи не указывает номер версии, VSS назначит номер версии по умолчанию 0,0.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header vswriter.h

См. также раздел

CreateVssExpressWriter

IVssExpressWriter