Fonctions de base de données

Ce document est destiné aux développeurs qui écrivent leurs propres programmes d’installation et développeurs qui souhaitent en savoir plus sur les tables de la 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’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ée et les outils de création. certaines fonctions d’accès au programme d’installation requièrent SQL des chaînes de requête pour interroger la base de données. les requêtes doivent adhérer à la syntaxe du SQLdu 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 aux bases 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 de vue.
MsiGetActiveDatabase Retourne la base de données active pour l’installation.
MsiViewGetColumnInfo Retourne des définitions ou des noms de colonnes.
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 de vue et fournit les paramètres requis.
MsiViewFetch Extrait l’enregistrement séquentiel suivant 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 de synthèse pour une transformation existante.
MsiDatabaseApplyTransform Applique une transformation à une base de données.
MsiDatabaseExport Exporte une table d’une base de données ouverte dans un fichier d’archive de 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.
MsiGetDatabaseState Retourne l’état de la base de données.

Fonctions de traitement des enregistrements

Fonction Description
MsiCreateRecord Crée un objet record 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 Affecte la valeur null à tous les champs d’un enregistrement.
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 de type 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é des informations de résumé

Fonction Description
MsiGetSummaryInformation Obtient le handle du flux d’informations récapitulatives de la base de données du programme d’installation.
MsiSummaryInfoGetProperty Obtient une propriété unique à partir des informations de résumé.
MsiSummaryInfoGetPropertyCount Retourne le nombre de propriétés dans le flux d’informations de résumé.
MsiSummaryInfoPersist Écrit les informations de résumé modifiées dans le flux d’informations de synthèse.
MsiSummaryInfoSetProperty Définit une propriété d’informations de résumé 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 internes booléens.
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’action.

Fonctions d’emplacement du programme d’installation

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

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 Affecte un état spécifié à une fonctionnalité.
MsiSetInstallLevel Définit le niveau d’installation d’une installation complète du produit.
MsiVerifyDiskSpace Vérifie que l’espace disque est suffisant.

Fonctions de l’interface utilisateur

Fonction Description
MsiEnableUIPreview Active le mode aperçu de l’interface utilisateur.
MsiPreviewBillboard Affiche un tableau blanc avec le contrôle hôte dans la boîte de dialogue affichée.
MsiPreviewDialog Affiche une boîte de dialogue non modale et inactive.

Toutes les fonctions prennent en charge les appels ANSI et Unicode. Pour utiliser ces fonctions, incluez MsiQuery. h et liez-le à msi. lib.

Fonctions d’installation

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