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.

[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