MsiDatabaseImport

[This is preliminary documentation and subject to change.]

The MsiDatabaseImport function imports an installer text archive table into an open database.

UINT MsiDatabaseImport(
  MSIHANDLE hDatabase,    // database handle
  LPCTSTR szFolderPath,   // folder containing archive files
  LPCTSTR szFileName      // table archive file to import
);
 

Parameters

hDatabase

Handle to the database.

szFolderPath

Specifies the path to the folder containing archive files.

szFileName

Specifies the name of the file to import.

Return Values

ERROR_BAD_PATHNAME

An invalid path was passed to the function.

ERROR_FUNCTION_FAILED

The function failed.

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_INVALID_PARAMETER

An invalid parameter was passed to the function.

ERROR_SUCCESS

The function succeeded.

Remarks

When you use the MsiDatabaseImport function to import a text archive table named _SummaryInformation into an installer database, the "05SummaryInformation" stream is written. This stream contains standard properties that are defined by COM and browseable by Windows® Explorer. The table rows consisting of pairs of property ID numbers with corresponding data values are written to the property stream.

When you use the MsiDatabaseImport function to import a text archive table named _SummaryInformation into an ODBC database, a normal table is created. If the data is a valid integer, the database interprets this integer as an integer property. If the data can be parsed as a date or date/time value (consisting of digits separated by slashes), the database interprets this value as a data/time value. Otherwise, the database interprets the data as a string value. Date values can have two formats: yyyy/mm/dd (time is entered as 0) or yyyy/mm/dd/hh/mm/ss (24-hour time). The summary information is customarily generated for new files by the release build process.

QuickInfo

  Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in msiquery.h.
  Import Library: Use msi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Database Access Reference, Database Management Functions