Partager via


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.