Метод Database.CreateTransformSummaryInfo

  • Статья

Метод CreateTransformSummaryInfo объекта Database создает и заполняет поток сводной информации существующего файла преобразования. Этот метод заполняет свойства базовыми и ссылочными значениями ProductCode и ProductVersion.

Синтаксис

Database.CreateTransformSummaryInfo(
  reference,
  storage,
  errorConditions,
  validation
)

Параметры

reference

Обязательная база данных, не включающая изменения.

storage

Имя созданного файла преобразования. Водить описание не обязательно.

errorConditions

Обязательные условия ошибок, которые должны подавляться при применении преобразования. Объедините одно или несколько из следующих значений условий ошибки.

Имя условия ошибки Значение
msiTransformErrorNone
0
 Ни одно из следующих условий.
msiTransformErrorAddExistingRow
1
 Добавляет уже существующую строку.
msiTransformErrorDeleteNonExistingRow
2
 Удаляет несуществующую строку.
msiTransformErrorAddExistingTable
4
 Добавляет уже существующую таблицу.
msiTransformErrorDeleteNonExistingTable
8
 Удаляет таблицу, которая не существует.
msiTransformErrorUpdateNonExistingRow
16
 Обновления несуществующую строку.
msiTransformErrorChangeCodepage
32
 Кодовая страница преобразования и базы данных не совпадает, и ни кодовая страница не является нейтральной.

validation

Требуется при применении преобразования к базе данных; показывает, какие свойства следует проверить, чтобы убедиться, что это преобразование может быть применено к базе данных. Все свойства содержатся в наборе свойств потока сводной информации.

Объедините одно или несколько из следующих значений.

Флаг проверки Значение
msiTransformValidationNone
0
 Проверка не выполнена.
msiTransformValidationLanguage
1
 Язык по умолчанию должен соответствовать базовой базе данных.
msiTransformValidationProduct
2
 Продукт должен соответствовать базовой базе данных.

Чтобы проверить версию продукта, сначала выберите один или несколько из этих трех флагов, чтобы указать, какая часть версии требуется проверить.

Флаг проверки Значение
msiTransformValidationMajorVer
8
 Проверяет только основную версию.
msiTransformValidationMinorVer
16
 Проверяет только основную и дополнительную версии.
msiTransformValidationUpdateVer
32
 Проверяет основные, дополнительные версии и версии обновления.

Затем выберите один из следующих вариантов, чтобы указать необходимую связь между версией продукта базы данных, к которой применяется преобразование, и версией базовой базы данных.

Флаг проверки Значение
msiTransformValidationLess
64
 Базовая версия примененной версии <
msiTransformValidationLessOrEqual
128
 Примененная версия <= базовая версия
msiTransformValidationEqual
256
 Примененная версия = базовая версия
msiTransformValidationGreaterOrEqual
512
 Примененная версия >= базовая версия
msiTransformValidationGreater
1024
 Базовая версия примененной версии >

Чтобы убедиться, что преобразование применяется к пакету с соответствующим UpgradeCode, установите следующий флаг.

Флаг проверки Значение
msiTransformValidationUpgradeCode
2048
 Проверяет, является ли преобразование соответствующим UpgradeCode.

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

Этот метод не возвращает значение.

Комментарии

Чтобы создать поток сводных сведений для преобразования, свойства ProductCode и ProductVersion должны быть определены в таблицах Property баз данных базовой и ссылочной баз данных. Если используется msiTransformValidationUpgradeCode, свойство UpgradeCode должно быть определено в обеих базах данных.

Требования

Требование Значение
Версия
 Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP
DLL
Msi.dll
IID
 IID_IDatabase определяется как 000C109D-0000-0000-C000-0000000000046

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

Преобразования базы данных