MsiViewGetColumnInfo, fonction (msiquery.h)

  • Article

La fonction MsiViewGetColumnInfo retourne un enregistrement contenant des noms de colonnes ou des définitions. Cette fonction retourne un handle qui doit être fermé à l’aide de MsiCloseHandle.

Syntaxe

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

Paramètres

[in] hView

Gérez vers la vue à partir de laquelle obtenir des informations de colonne.

[in] eColumnInfo

Spécifie un indicateur indiquant le type d’informations nécessaires. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
MSICOLINFO_NAMES
 Les noms de colonnes sont retournés.
MSICOLINFO_TYPES
 Les définitions sont retournées.

[out] phRecord

Pointeur vers un handle pour recevoir l’enregistrement de données d’informations de colonne.

Valeur retournée

Notez que dans les situations de mémoire insuffisante, cette fonction peut déclencher une exception STATUS_NO_MEMORY.

Remarques

La description de colonne retournée par MsiViewGetColumnInfo est au format décrit dans la section : Format de définition de colonne. Chaque colonne est décrite par une chaîne dans le champ d’enregistrement correspondant. La chaîne de définition se compose d’une lettre unique représentant le type de données suivi de la largeur de la colonne (en caractères le cas échéant, octets dans le cas contraire). Une largeur de zéro désigne une largeur non délimitée (par exemple, les champs et flux de texte longs). Une lettre majuscule indique que les valeurs Null sont autorisées dans la colonne.

Notez qu’il est recommandé d’utiliser des variables de type PMSIHANDLE, car le programme d’installation ferme les objets PMSIHANDLE en dehors de leur portée, tandis que vous devez fermer les objets MSIHANDLE en appelant MsiCloseHandle. Pour plus d’informations, consultez la section Utiliser PMSIHANDLE au lieu de HANDLE dans les Bonnes pratiques de Windows Installer.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
Plateforme cible Windows
En-tête msiquery.h
Bibliothèque Msi.lib
DLL Msi.dll