Função MsiViewGetColumnInfo (msiquery.h)

A função MsiViewGetColumnInfo retorna um registro que contém nomes de coluna ou definições. Essa função retorna um identificador que deve ser fechado usando MsiCloseHandle.

Sintaxe

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

Parâmetros

[in] hView

Manipule para a exibição da qual obter informações de coluna.

[in] eColumnInfo

Especifica um sinalizador que indica qual tipo de informação é necessário. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
MSICOLINFO_NAMES	Os nomes das colunas são retornados.
MSICOLINFO_TYPES	As definições são retornadas.

[out] phRecord

Ponteiro para um identificador para receber o registro de dados de informações da coluna.

Retornar valor

Observe que, em situações de memória baixa, essa função pode gerar uma exceção STATUS_NO_MEMORY.

Comentários

A descrição da coluna retornada por MsiViewGetColumnInfo está no formato descrito na seção: Formato de Definição de Coluna. Cada coluna é descrita por uma cadeia de caracteres no campo de registro correspondente. A cadeia de caracteres de definição consiste em uma só letra que representa o tipo de dados seguido da largura da coluna (em caracteres quando aplicável, caso contrário, bytes). Uma largura igual a zero designa uma largura não limitada (por exemplo, fluxos e campos de texto longos). Uma letra maiúscula indica que valores nulos são permitidos na coluna.

Observe que é recomendável usar variáveis do tipo PMSIHANDLE porque o instalador fecha objetos PMSIHANDLE à medida que eles saem do escopo, enquanto você deve fechar objetos MSIHANDLE chamando MsiCloseHandle. Para obter mais informações, confira a seção Use PMSIHANDLE em vez de HANDLE nas Melhores práticas do Windows Installer.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
Plataforma de Destino	Windows
Cabeçalho	msiquery.h
Biblioteca	Msi.lib
DLL	Msi.dll