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.