VC++利用MSI API创建基本安装包文件

顾言

发布时间：2026-10-14 | 6人浏览过

原创

在VC++开发中，有时需要为生成的可执行文件附加一个标准的安装包（MSI）。通过调用Windows内置的MSI DLL API，开发者可以在程序内部快速实例化一个基本的MSI数据库结构。本文将展示核心代码逻辑，说明如何利用MsiOpenDatabase等函数完成文件的创建。

实现目标与原理

Windows Installer (MSI) 技术提供了强大的应用程序分发能力。通过引入相应的头文件和库链接，VC++程序可以像操作普通数据库一样操作MSI文件。本例的核心逻辑是：在内存或磁盘上初始化一个空白的MSI数据库句柄，将其持久化到硬盘生成Setup.msi文件，并进行基础的元数据提交，以确保文件格式正确且非损坏状态。

第1步：准备工程依赖环境

由于MSI属于系统级组件，必须包含对应的SDK头文件并在项目中链接静态库。这确保了编译器能够识别相关的API定义，并能够在运行时动态加载功能模块。

头文件：必须包含TCHAR.H以支持跨Unicode/ANSI编译，以及核心的WINDOWS.H和MSI.H、MSIQUERY.H。
库文件：需链接msi.lib，通常使用#pragma指令直接在源文件中声明。

第2步：调用API创建数据库实例

这是程序的主流程。我们需要从_tWinMain入口开始，利用MsiOpenDatabase函数申请创建一个新的MSI文件。该参数设置为MSIDBOPEN_CREATEDIRECT表示新建模式。

#include <TCHAR.H>
#include <WINDOWS.H>

#pragma comment(lib,"msi.lib")
#include <MSI.H>
#include <MSIQUERY.H>

INT APIENTRY _tWinMain(
HINSTANCE,
HINSTANCE,
LPTSTR,
INT)
{
    MSIHANDLE msiHandle=NULL;
    //create msi database.
    UINT openResult=MsiOpenDatabase(
        _T("Setup.msi"),
        MSIDBOPEN_CREATEDIRECT,
        &msiHandle);

如果打开失败（返回值不等于ERROR_SUCCESS），需要通过MsiGetLastErrorRecord获取错误记录，并使用标准的FormatMessage将错误码转换为可读字符串，通过弹窗展示给用户以便排查。

第3步：提交数据库变更

为了保持数据的完整性（ACID特性中的一致性），在进行后续可能的表项插入后（当前仅为框架演示），应显式调用MsiDatabaseCommit。此步骤将内存中的临时状态写入到磁盘上的Setup.msi文件中，确保其能被Orca等工具正确识别为标准MSI架构。

    //commit msi database.
    UINT commitResult=MsiDatabaseCommit(msiHandle);
    if(commitResult != ERROR_SUCCESS)
    {
        LPVOID formatMsg=NULL;
        MSIHANDLE errorCode=MsiGetLastErrorRecord();
        FormatMessage(
            FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,
            NULL,
            errorCode,
            MAKELANGID(LANG_NEUTRAL,SUBLANG_SYS_DEFAULT),
            (LPTSTR)&formatMsg,
            0,
            NULL);
        MessageBoxEx(
            NULL,
            (LPTSTR)formatMsg,
            _T("tip window"),
            MB_OK,
            MAKELANGID(LANG_NEUTRAL,SUBLANG_SYS_DEFAULT));
        LocalFree(formatMsg);
        formatMsg=NULL;
        return -1;
    }

第4步：安全关闭句柄并清理资源

最后一步至关重要，必须释放MSI数据库句柄以防止内存泄漏。使用MsiCloseHandle关闭操作，同样需要进行错误码检查，确保句柄已被操作系统正确回收。

    //close msi database handle.
    UINT closeResult=MsiCloseHandle(msiHandle);
    if(closeResult != ERROR_SUCCESS)
    {
        LPVOID formatMsg=NULL;
        MSIHANDLE errorCode=MsiGetLastErrorRecord();
        FormatMessage(
            FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,
            NULL,
            errorCode,
            MAKELANGID(LANG_NEUTRAL,SUBLANG_SYS_DEFAULT),
            (LPTSTR)&formatMsg,
            0,
            NULL);
        MessageBoxEx(
            NULL,
            (LPTSTR)formatMsg,
            _T("tip window"),
            MB_OK,
            MAKELANGID(LANG_NEUTRAL,SUBLANG_SYS_DEFAULT));
        LocalFree(formatMsg);
        formatMsg=NULL;
        return -1;
    }
    return 0;
}