MsiDatabaseImportA, fonction (msiquery.h)

La fonction MsiDatabaseImport importe un programme d’installation fichier d’archivage texte dans une table de base de données ouverte.

Syntaxe

UINT MsiDatabaseImportA(
  [in] MSIHANDLE hDatabase,
  [in] LPCSTR    szFolderPath,
  [in] LPCSTR    szFileName
);

Paramètres

[in] hDatabase

Handle vers la base de données obtenue à partir de MsiOpenDatabase.

[in] szFolderPath

Spécifie le chemin d’accès au dossier qui contient des fichiers d’archivage.

[in] szFileName

Spécifie le nom du fichier à importer.

Valeur de retour

La fonction MsiDatabaseImport retourne l’une des valeurs suivantes :

Remarques

Lorsque vous utilisez la fonction MsiDatabaseImport pour importer une table d’archive de texte nommée _SummaryInformation dans une base de données du programme d’installation, vous écrivez le flux « 05SummaryInformation ». Ce flux contient des propriétés standard qui peuvent être consultées à l’aide de l’Explorateur Windows et qui sont définies par COM. Les lignes de la table sont écrites dans le flux de propriétés sous forme de paires de numéros d’ID de propriété et de valeurs de données correspondantes. Consultez ensemble de propriétés de flux d’informations récapitulatives. La date et l’heure dans _SummaryInformation sont au format : AAAA/MM/DD hh ::mm ::ss. Par exemple, 1999/03/22 15:25:45. Si la table contient des flux binaires, le nom du flux se trouve dans le champ de données et le flux réel est récupéré à partir d’un fichier de ce nom dans un sous-dossier portant le même nom que la table.

Les fichiers d’archive texte exportés à partir d’une base de données par MsiDatabaseExport sont destinés à être utilisés avec des systèmes de contrôle de version et ne sont pas destinés à être utilisés comme moyen de modifier des données. Utilisez les fonctions et outils de l’API de base de données conçus à cet effet. Notez que les caractères de contrôle dans les fichiers d’archive de texte sont traduits pour éviter les conflits avec les délimiteurs de fichiers. Si un fichier d’archive de texte contient des données non ASCII, il est marqué avec la page de codes des données et ne peut être importé que dans une base de données de cette page de codes exacte ou dans une base de données neutre. Les bases de données neutres sont définies sur la page de codes du fichier importé. Une base de données peut être définie inconditionnellement sur une page de codes particulière en important une pseudo table nommée : _ForceCodepage. Le format d’un tel fichier est : deux lignes vides, suivies d’une ligne qui contient la page de codes numérique, un délimiteur d’onglets et la chaîne exacte : _ForceCodepage

Cette fonction ne peut pas être appelée à partir d’actions personnalisées. Un appel à cette fonction à partir d’une action personnalisée provoque l’échec de la fonction.

Si la fonction échoue, vous pouvez obtenir des informations d’erreur étendues à l’aide de MsiGetLastErrorRecord.

Exigences

Voir aussi

fonctions de gestion des bases de données

fichiers d’archive texte