Fonctions de base de données

Ce matériel est destiné aux développeurs qui écrivent leurs propres programmes d’installation et aux développeurs qui souhaitent en savoir plus sur les tables de base de données du programme d’installation. Pour obtenir des informations générales sur le programme d’installation, consultez À propos de Windows Installer.

Vous pouvez utiliser les fonctions d’accès du programme d’installation pour accéder à la base de données et au processus d’installation. Ces fonctions doivent uniquement être utilisées par les actions d’installation personnalisées et les outils de création. Certaines fonctions d’accès au programme d’installation nécessitent des chaînes de requête SQL pour interroger la base de données. Les requêtes doivent respecter la syntaxe SQL du programme d’installation.

Cette rubrique répertorie les fonctions d’accès à la base de données du programme d’installation par catégorie.

Fonctions générales d’accès à la base de données

Fonction	Description
MsiDatabaseCommit	Valide les modifications apportées à une base de données.
MsiDatabaseGetPrimaryKeys	Retourne les noms de toutes les colonnes clés primaires.
MsiDatabaseIsTablePersistent	Retourne une énumération décrivant l’état d’une table.
MsiDatabaseOpenView	Prépare une requête de base de données et crée un objet d’affichage.
MsiGetActiveDatabase	Retourne la base de données active pour l’installation.
MsiViewGetColumnInfo	Retourne des noms de colonnes ou des définitions.
MsiOpenDatabase	Ouvre un fichier de base de données pour l’accès aux données.
MsiViewClose	Libère le jeu de résultats pour une vue exécutée.
MsiViewExecute	Exécute la requête d’affichage et fournit les paramètres requis.
MsiViewFetch	Extrait l’enregistrement séquentiel suivant à partir de la vue.
MsiViewGetError	Retourne l’erreur qui s’est produite dans la fonction MsiViewModify.
MsiViewModify	Met à jour un enregistrement extrait.

 

Fonctions de gestion de base de données

Fonction	Description
MsiCreateTransformSummaryInfo	Crée des informations récapitulatives pour une transformation existante.
MsiDatabaseApplyTransform	Applique une transformation à une base de données.
MsiDatabaseExport	Exporte une table d’une base de données ouverte vers un fichier d’archive texte.
MsiDatabaseGenerateTransform	Génère un fichier de transformation des différences entre deux bases de données.
MsiDatabaseImport	Importe une table d’archive de texte du programme d’installation dans une base de données ouverte.
MsiDatabaseMerge	Fusionne deux bases de données.
MsiGetDatabaseState	Retourne l’état de la base de données.

 

Fonctions de traitement des enregistrements

Fonction	Description
MsiCreateRecord	Crée un nouvel objet d’enregistrement avec un nombre spécifié de champs.
MsiFormatRecord	Met en forme les données et les propriétés des champs d’enregistrement à l’aide d’une chaîne de format.
MsiRecordClearData	Définit tous les champs d’un enregistrement sur Null.
MsiRecordDataSize	Retourne la longueur d’un champ d’enregistrement.
MsiRecordGetFieldCount	Retourne le nombre de champs dans un enregistrement.
MsiRecordGetInteger	Retourne la valeur entière d’un champ d’enregistrement.
MsiRecordGetString	Retourne la valeur de chaîne d’un champ d’enregistrement.
MsiRecordIsNull	Indique si un champ d’enregistrement a la valeur Null.
MsiRecordReadStream	Lit les octets d’un champ de flux d’enregistrement dans une mémoire tampon.
MsiRecordSetInteger	Définit un champ d’enregistrement sur un champ entier.
MsiRecordSetStream	Définit un champ de flux d’enregistrement à partir d’un fichier.
MsiRecordSetString	Copie une chaîne dans le champ désigné.

 

Fonctions de propriété d’informations de résumé

Fonction	Description
MsiGetSummaryInformation	Obtient le handle vers le flux d’informations récapitulatives de la base de données du programme d’installation.
MsiSummaryInfoGetProperty	Obtient une propriété unique à partir des informations récapitulatives.
MsiSummaryInfoGetPropertyCount	Retourne le nombre de propriétés dans le flux d’informations récapitulatives.
MsiSummaryInfoPersist	Écrit les informations récapitulatives modifiées dans le flux d’informations récapitulatives.
MsiSummaryInfoSetProperty	Définit une propriété d’informations récapitulative unique.

 

Fonctions d’accès à l’état du programme d’installation

Fonction	Description
MsiGetLanguage	Retourne la langue numérique de l’installation actuelle.
MsiGetLastErrorRecord	Retourne le dernier enregistrement d’erreur retourné pour le processus appelant.
MsiGetMode	Retourne l’un des états d’installation interne booléenne.
MsiGetProperty	Obtient la valeur d’une propriété de programme d’installation.
MsiSetProperty	Définit la valeur d’une propriété d’installation.
MsiSetMode	Définit un état booléen du moteur interne.

 

Fonctions d’action du programme d’installation

Fonction	Description
MsiDoAction	Exécute une action intégrée, une action personnalisée ou une action de l’Assistant interface utilisateur.
MsiEvaluateCondition	Évalue une expression conditionnelle contenant des noms de propriétés et des valeurs.
MsiProcessMessage	Envoie un enregistrement d’erreur au programme d’installation pour traitement.
MsiSequence	Exécute une séquence d’actions.

 

Fonctions d’emplacement du programme d’installation

Fonction	Description
MsiGetSourcePath	Retourne le chemin d’accès source complet d’un dossier dans la table Directory.
MsiGetTargetPath	Retourne le chemin d’accès cible complet d’un dossier dans la table Directory.
MsiSetTargetPath	Définit le chemin d’accès cible complet d’un dossier dans la table Directory.

 

Fonctions de sélection du programme d’installation

Fonction	Description
MsiEnumComponentCosts	Énumère l’espace disque nécessaire par lecteur pour installer un composant.
MsiGetComponentState	Obtient l’état d’un composant.
MsiGetFeatureCost	Retourne l’espace disque requis par une fonctionnalité.
MsiGetFeatureState	Obtient l’état d’une fonctionnalité.
MsiGetFeatureValidStates	Retourne un état d’installation valide.
MsiSetComponentState	Définit un composant à l’état spécifié.
MsiSetFeatureAttributes	Modifie les attributs par défaut d’une fonctionnalité au moment de l’exécution.
MsiSetFeatureState	Définit une fonctionnalité à un état spécifié.
MsiSetInstallLevel	Définit le niveau d’installation d’une installation complète d’un produit.
MsiVerifyDiskSpace	Vérifie si l’espace disque est suffisant.

 

Fonctions de l’interface utilisateur

Fonction	Description
MsiEnableUIPreview	Active le mode d’aperçu de l’interface utilisateur.
MsiPreviewBillboard	Affiche un billboard avec le contrôle hôte dans la boîte de dialogue affichée.
MsiPreviewDialog	Affiche une boîte de dialogue comme étant sans mode et inactive.

 

Toutes les fonctions prennent en charge les appels ANSI et Unicode. Pour utiliser ces fonctions, incluez MsiQuery.h et créez un lien avec Msi.lib.

Fonctions d’installation

En plus des fonctions d’accès à la base de données répertoriées ci-dessus, vous créez un package d’installation pour une application à l’aide des fonctions du programme d’installation répertoriées dans la section Référence des fonctions du programme d’installation.