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


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

Функция MsiCreateRecord создает новый объект записи с указанным количеством полей. Эта функция возвращает дескриптор, который должен быть закрыт с помощью MsiCloseHandle.

Синтаксис

MSIHANDLE MsiCreateRecord(
  [in] UINT cParams
);

Параметры

[in] cParams

Указывает количество полей, которые будут содержаться в записи. Максимальное количество полей в записи ограничено 65535.

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

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

Если функция завершается сбоем, возвращаемое значение равно NULL.

Комментарии

Поле 0 объекта записи, созданного функцией MsiCreateRecord , используется для строк форматирования и кодов операций и не включается в число, указанное cParams. Все поля инициализируются значением NULL.

Обратите внимание, что рекомендуется использовать переменные типа PMSIHANDLE, так как установщик закрывает объекты PMSIHANDLE по мере их выхода из область, тогда как необходимо закрывать объекты MSIHANDLE путем вызова MsiCloseHandle. Дополнительные сведения см. в разделе Использование PMSIHANDLE вместо HANDLE статьи Рекомендации по установщику Windows.

Требования

Требование Значение
Минимальная версия клиента Установщик 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
Целевая платформа Windows
Header msiquery.h
Библиотека Msi.lib
DLL Msi.dll

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

Функции базы данных

Функции обработки записей