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.