Fonctions de base de données

Ce matériel est destiné aux développeurs qui écrivent leurs propres programmes d’installation et 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 au programme d’installation pour accéder à la base de données et au processus d’installation. Ces fonctions ne doivent être utilisées que par les actions d’installation personnalisées et les outils de création. Certaines des 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 adhérer au programme d’installation syntaxe SQL.

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

Fonctions d’accès aux bases de données générales

Fonction	Description
msiDatabaseCommit	Valide les modifications apportées à une base de données.
MsiDatabaseGetPrimaryKeys	Retourne les noms de toutes les colonnes de clé primaire.
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	Récupère l’enregistrement séquentiel suivant à partir de la vue.
MsiViewGetError	Retourne l’erreur qui s’est produite dans la fonctionMsiViewModify.
msiViewModify	Met à jour un enregistrement récupéré.

 

Fonctions de gestion des bases 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’archivage texte.
MsiDatabaseGenerateTransform	Génère un fichier de transformation de 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 ensemble.
MsiGetDatabaseState	Retourne l’état de la base de données.

 

Fonctions de traitement des enregistrements

Fonction	Description
msiCreateRecord	Crée un objet d’enregistrement avec le 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 d’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 récapitulatives

Fonction	Description
MsiGetSummaryInformation	Obtient le handle pour résumer le flux d’informations 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éen.
MsiGetProperty	Obtient la valeur d’une propriété du 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 et des valeurs de propriété.
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 par lecteur requis 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 du produit.
msiVerifyDiskSpace	Vérifie l’espace disque suffisant.

 

Fonctions d’interface utilisateur

Fonction	Description
MsiEnableUIPreview	Active le mode d’aperçu de l’interface utilisateur.
MsiPreviewBillboard	Affiche un panneau d’affichage avec le contrôle hôte dans la boîte de dialogue affichée.
msiPreviewDialog	Affiche une boîte de dialogue en tant que modeless et inactif.

 

Toutes les fonctions prennent en charge les appels ANSI et Unicode. Pour utiliser ces fonctions, incluez MsiQuery.h et liez 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 d’installation répertoriées dans la section Informations de référence sur la fonction d’installation.