Share via

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

  • Статья

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

Синтаксис

UINT MsiViewGetColumnInfo(
  [in]  MSIHANDLE  hView,
  [in]  MSICOLINFO eColumnInfo,
  [out] MSIHANDLE  *phRecord
);

Параметры

[in] hView

Дескриптор представления, из которого требуется получить сведения о столбце.

[in] eColumnInfo

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

Значение Значение
MSICOLINFO_NAMES
 Возвращаются имена столбцов.
MSICOLINFO_TYPES
 Возвращаются определения.

[out] phRecord

Указатель на дескриптор для получения записи данных о столбце.

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

Обратите внимание, что при нехватке памяти эта функция может вызвать исключение STATUS_NO_MEMORY.

Комментарии

Описание столбца, возвращаемое MsiViewGetColumnInfo , имеет формат, описанный в разделе Формат определения столбца. Каждый столбец описывается строкой в соответствующем поле записи. Строка определения состоит из одной буквы, представляющей тип данных, за которой следует ширина столбца (в символах, если применимо, в байтах в противном случае). Нулевая ширина обозначает неограничимую ширину (например, длинные текстовые поля и потоки). Прописная буква указывает, что в столбце разрешены значения 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