Funzione MsiViewGetColumnInfo (msiquery.h)

  • Articolo

La funzione MsiViewGetColumnInfo restituisce un record contenente nomi di colonna o definizioni. Questa funzione restituisce un handle che deve essere chiuso usando MsiCloseHandle.

Sintassi

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

Parametri

[in] hView

Gestire la vista da cui ottenere informazioni sulla colonna.

[in] eColumnInfo

Specifica un flag che indica il tipo di informazioni necessarie. Questo parametro deve essere uno dei valori seguenti.

Valore Significato
MSICOLINFO_NAMES
 I nomi di colonna vengono restituiti.
MSICOLINFO_TYPES
 Le definizioni vengono restituite.

[out] phRecord

Puntatore a un handle per ricevere il record di dati delle informazioni sulla colonna.

Valore restituito

Si noti che in situazioni di memoria insufficiente, questa funzione può generare un'eccezione STATUS_NO_MEMORY.

Commenti

La descrizione della colonna restituita da MsiViewGetColumnInfo è nel formato descritto nella sezione: Formato definizione colonna. Ogni colonna è descritta da una stringa nel campo record corrispondente. La stringa di definizione è costituita da una singola lettera che rappresenta il tipo di dati seguito dalla larghezza della colonna (in caratteri, in caso contrario, byte). Una larghezza di zero designa una larghezza non associato ,ad esempio campi di testo lunghi e flussi. Una lettera maiuscola indica che i valori Null sono consentiti nella colonna.

Si noti che è consigliabile usare variabili di tipo PMSIHANDLE perché il programma di installazione chiude gli oggetti PMSIHANDLE mentre escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle. Per altre informazioni, vedere Usare PMSIHANDLE anziché la sezione HANDLE nelle procedure consigliate di Windows Installer.

Requisiti

Requisito Valore
Client minimo supportato Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP
Piattaforma di destinazione Windows
Intestazione msiquery.h
Libreria Msi.lib
DLL Msi.dll