Функция MsiDatabaseMergeA (msiquery.h)

Функция MsiDatabaseMerge объединяет две базы данных, что позволяет дублировать строки.

Синтаксис

UINT MsiDatabaseMergeA(
  [in] MSIHANDLE hDatabase,
  [in] MSIHANDLE hDatabaseMerge,
  [in] LPCSTR    szTableName
);

Параметры

[in] hDatabase

Дескриптор базы данных, полученный из MsiOpenDatabase.

[in] hDatabaseMerge

Дескриптор базы данных, полученный из MsiOpenDatabase для слияния с базовой базой данных.

[in] szTableName

Имя таблицы для получения конфликт слияния сведений.

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

Функция MsiDatabaseMerge возвращает одно из следующих значений:

Комментарии

Функцию MsiDatabaseMerge и метод Merge объекта Database нельзя использовать для слияния модуля, включенного в пакет установки. Их не следует использовать для слияния модулей в пакет установщика Windows. Чтобы включить модуль слияния в пакет установки, авторы пакетов установки должны следовать рекомендациям, описанным в разделе Применение модулей слияния .

MsiDatabaseMerge не копирует внедренные cab-файлы или внедренные преобразования из эталонной базы данных в целевую базу данных. Внедренные потоки данных, перечисленные в двоичной таблице или таблице значков , копируются из эталонной базы данных в целевую базу данных. Хранилище, внедренное в эталонную базу данных, не копируется в целевую базу данных.

Функция MsiDatabaseMerge объединяет данные двух баз данных. Эти базы данных должны иметь одну и ту же кодовую страницу. MsiDatabaseMerge завершается сбоем , если какие-либо таблицы или строки в базах данных конфликтуют. Конфликт возникает, если данные в любой строке первой базы данных отличаются от данных в соответствующей строке второй базы данных. Соответствующие строки находятся в одной таблице обеих баз данных и имеют одинаковый первичный ключ в обеих базах данных. Таблицы неконфлиционных баз данных должны содержать одинаковое количество первичных ключей, одинаковое количество столбцов, одинаковые типы столбцов, одинаковые имена столбцов и одинаковые данные в строках с одинаковыми первичными ключами. Временные столбцы, однако, не имеют значения в количестве столбцов, и соответствующие таблицы могут иметь разное количество временных столбцов, не создавая конфликтов, если постоянные столбцы совпадают.

Если число, тип или имя столбцов в соответствующих таблицах отличаются, схема двух баз данных несовместима, и установщик останавливает обработку таблиц и слияние завершается сбоем. Перед проверкой на наличие конфликтов слияния строк установщик проверяет, имеют ли две базы данных одну и ту же схему. Если возвращается ERROR_DATATYPE_MISMATCH, вы гарантируете, что базы данных не были изменены.

Если данные в определенных строках отличаются, это строка конфликт слияния, установщик возвращает ERROR_FUNCTION_FAILED и создает таблицу с именем szTableName. Первый столбец этой таблицы — это имя таблицы с конфликтом. Второй столбец содержит количество строк в таблице, в которых возникает конфликт. Таблица, сообщающая о конфликтах, выглядит следующим образом.

Эту функцию нельзя вызвать из пользовательских действий. Вызов этой функции из настраиваемого действия приводит к сбою функции.

В случае сбоя функции можно получить расширенные сведения об ошибке с помощью MsiGetLastErrorRecord.

Требования

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

Формат определения столбца

Функции управления базами данных