Compartir a través de

Función MsiViewGetColumnInfo (msiquery.h)

  • Artículo

La función MsiViewGetColumnInfo devuelve un registro que contiene nombres de columna o definiciones. Esta función devuelve un identificador que se debe cerrar mediante MsiCloseHandle.

Sintaxis

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

Parámetros

[in] hView

Controle a la vista desde la que se va a obtener información de columna.

[in] eColumnInfo

Especifica una marca que indica qué tipo de información es necesaria. Este parámetro puede ser uno de los siguientes valores.

Value Significado
MSICOLINFO_NAMES
 Se devuelven los nombres de columna.
MSICOLINFO_TYPES
 Se devuelven definiciones.

[out] phRecord

Puntero a un identificador para recibir el registro de datos de información de columna.

Valor devuelto

Tenga en cuenta que, en situaciones de memoria baja, esta función puede generar una excepción de STATUS_NO_MEMORY.

Comentarios

La descripción de columna devuelta por MsiViewGetColumnInfo tiene el formato descrito en la sección: Formato de definición de columna. Cada columna se describe mediante una cadena en el campo de registro correspondiente. La cadena de definición consta de una sola letra que representa el tipo de datos seguido del ancho de la columna (en caracteres si se puede, si no en bytes). Un ancho de cero designa un ancho sin enlazar (por ejemplo, campos de texto largos y secuencias). Una letra mayúscula indica que se permiten valores NULL en la columna.

Tenga en cuenta que se recomienda usar variables de tipo PMSIHANDLE porque el instalador cierra los objetos PMSIHANDLE a medida que salen del ámbito, mientras que debe cerrar objetos MSIHANDLE llamando a MsiCloseHandle. Para más información, consulte la sección Uso de PMSIHANDLE, en lugar de HANDLE en los procedimientos recomendados de Windows Installer.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP
Plataforma de destino Windows
Encabezado msiquery.h
Library Msi.lib
Archivo DLL Msi.dll