ShellExecute在C语言中如何使用？

这是一个在 Windows 平台下非常常用的 API 函数，主要用于执行外部程序、打开文件或 URL。

什么是 ShellExecute？

ShellExecute 是 Windows Shell (外壳) 的一个核心函数，它允许你的程序调用系统默认的关联程序来执行一个特定的操作。

你可以把它想象成一个“万能启动器”：

• 想打开一个网页？告诉它网址，它会用默认浏览器打开。
• 想打开一个 Word 文档？告诉它文件路径，它会用 Word 打开。
• 想发送一封邮件？告诉它邮件地址，它会用默认邮件客户端打开。
• 想运行一个计算器程序？告诉它 calc.exe 的路径，它会直接启动计算器。

相比于使用 CreateProcess 来创建进程，ShellExecute 更简单、更灵活，因为它利用了 Windows 系统已经配置好的文件关联和 Shell 处理逻辑。

函数原型

ShellExecute 在 shellapi.h 头文件中声明，使用前需要包含它。

#include <shellapi.h> // 必须包含这个头文件
HINSTANCE ShellExecute(
  HWND    hwnd,
  LPCSTR  lpOperation,
  LPCSTR  lpFile,
  LPCSTR  lpParameters,
  LPCSTR  lpDirectory,
  INT     nShowCmd
);

参数详解

让我们逐个分析每个参数的作用：

返回值

ShellExecute 返回一个 HINSTANCE 类型的值，在 16 位 Windows 中，它是一个实例句柄，在 32 位及以后的 Windows 中，它被用作一个状态码。

你需要检查返回值是否小于或等于 32，以判断操作是否成功。

如果操作成功,返回值将大于 32，它代表了新运行程序的实例句柄（在 32 位系统中，这个值意义不大，通常我们只关心是否成功）。

编程示例

在编译时,你还需要链接 shellapi.lib 库，在 Visual Studio 中通常会自动处理，在命令行编译时需要加上 /shellapi.lib。

示例 1：打开一个文本文件

#include <windows.h>
#include <shellapi.h>
#include <tchar.h> // 为了使用 _T 宏，使代码支持 Unicode
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
    // 定义要打开的文件路径
    LPCTSTR szFilePath = _T("C:\\test.txt"); // 请确保这个文件存在
    // 调用 ShellExecute
    HINSTANCE hResult = ShellExecute(
        NULL,                    // 父窗口句柄
        _T("open"),              // 操作：打开
        szFilePath,              // 文件路径
        NULL,                    // 无参数
        NULL,                    // 默认目录
        SW_SHOWNORMAL           // 正常显示窗口
    );
    // 检查返回值
    if ((INT_PTR)hResult <= 32) {
        // 操作失败
        MessageBox(NULL, _T("无法打开文件！"), _T("错误"), MB_OK | MB_ICONERROR);
        return 1;
    }
    // 操作成功
    MessageBox(NULL, _T("文件已成功打开！"), _T("成功"), MB_OK | MB_ICONINFORMATION);
    return 0;
}

示例 2：打开网页

#include <windows.h>
#include <shellapi.h>
#include <tchar.h>
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
    LPCTSTR szUrl = _T("https://www.baidu.com");
    HINSTANCE hResult = ShellExecute(
        NULL,
        _T("open"),
        szUrl,
        NULL,
        NULL,
        SW_SHOWNORMAL
    );
    if ((INT_PTR)hResult <= 32) {
        MessageBox(NULL, _T("无法打开网页！"), _T("错误"), MB_OK | MB_ICONERROR);
        return 1;
    }
    return 0;
}

示例 3：发送邮件

#include <windows.h>
#include <shellapi.h>
#include <tchar.h>
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
    // 可以设置收件人、主题和正文
    LPCTSTR szMailTo = _T("mailto:recipient@example.com?subject=Hello%20World&body=This%20is%20a%20test%20email.");
    HINSTANCE hResult = ShellExecute(
        NULL,
        _T("open"),
        szMailTo,
        NULL,
        NULL,
        SW_SHOWNORMAL
    );
    if ((INT_PTR)hResult <= 32) {
        MessageBox(NULL, _T("无法打开邮件客户端！"), _T("错误"), MB_OK | MB_ICONERROR);
        return 1;
    }
    return 0;
}

注意: URL 中的特殊字符（如 , &, , 空格）需要进行 URL 编码，空格通常编码为 %20。

ShellExecuteEx - 更强大的版本

ShellExecute 的一个更现代、更强大的替代品是 ShellExecuteEx，它返回一个 SHELLEXECUTEINFO 结构体，包含更丰富的信息，并且支持异步操作。

ShellExecuteEx 的主要优点：

1. 获取进程 ID: 可以通过 SHELLEXECUTEINFO 结构中的 hProcess 成员获取新创建进程的句柄，从而得到其进程 ID。
2. 异步执行: 可以设置 fMask 成员中的 SEE_MASK_NOCLOSEPROCESS 标志，然后使用 WaitForSingleObject 来等待新进程结束，这对于需要等待外部程序执行完成后再继续的脚本程序非常有用。

ShellExecuteEx 简单示例

#include <windows.h>
#include <shellapi.h>
#include <tchar.h>
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
    SHELLEXECUTEINFO sei = { 0 };
    sei.cbSize = sizeof(SHELLEXECUTEINFO);
    sei.fMask = SEE_MASK_NOCLOSEPROCESS; // 关键：告诉系统不要关闭进程句柄
    sei.hwnd = NULL;
    sei.lpVerb = _T("open");
    sei.lpFile = _T("notepad.exe"); // 打记事本
    sei.lpParameters = NULL;
    sei.lpDirectory = NULL;
    sei.nShow = SW_SHOWNORMAL;
    if (!ShellExecuteEx(&sei)) {
        DWORD dwError = GetLastError();
        MessageBox(NULL, _T("ShellExecuteEx 失败!"), _T("错误"), MB_OK | MB_ICONERROR);
        return 1;
    }
    // 等记事本程序关闭
    WaitForSingleObject(sei.hProcess, INFINITE);
    // 关闭句柄
    CloseHandle(sei.hProcess);
    MessageBox(NULL, _T("记事本已关闭!"), _T("信息"), MB_OK | MB_ICONINFORMATION);
    return 0;
}

选择建议：

• 如果只是简单地打开一个文件、URL 或运行一个程序，不关心它何时结束，ShellExecute 是最简单、最直接的选择。
• 如果你的程序需要等待外部程序执行完毕后再继续,或者需要获取新进程的 ID 或句柄，那么应该使用 ShellExecuteEx。