如何正确地用 C++ 创建 Windows 快捷方式文件？

如何在 C++ 中正确创建 Windows 快捷方式文件

问题

Windows 快捷方式文件（.lnk）是一种特殊文件类型，它指向实际目标文件（程序、文档或文件夹）。创建 Windows 快捷方式需要使用 IShellLink 和 IPersistFile 接口，但如果没有正确配置这些接口，可能会导致 .lnk 文件无法正常工作。

解决方案

为了正确创建 Windows 快捷方式文件，需要执行以下步骤：

1. 创建 IShellLink 接口

IShellLink* psl;
CoCreateInstance(CLSID_ShellLink, NULL, CLSCTX_INPROC_SERVER, IID_IShellLink, (LPVOID*)&psl);

2. 设置快捷方式属性

psl->SetPath(L"C:\\Program Files\\My Program\\start.exe"); // 目标路径
psl->SetArguments(L"/arg1 /arg2"); // 可选参数
psl->SetDescription(L"My Program Shortcut"); // 可选

3. 获取 IPersistFile 接口

IPersistFile* ppf;
psl->QueryInterface(IID_IPersistFile, (LPVOID*)&ppf);

4. 保存快捷方式

WCHAR wszPath[MAX_PATH];
MultiByteToWideChar(CP_ACP, 0, "C:\\Users\\Me\\Desktop\\MyShortcut.lnk", -1, wszPath, MAX_PATH);
ppf->Save(wszPath, TRUE);

5. 释放接口

ppf->Release();
psl->Release();

6. 其他注意事项

• 确保目标路径有效，否则快捷方式将无法启动目标程序。
• 使用 MultiByteToWideChar 函数将 ANSI 路径转换为 Unicode 路径，因为 Windows API 需要 Unicode 字符串。
• 使用 CoInitialize 和 CoUninitialize 函数初始化和释放 COM 库。

示例代码

以下是一个完整的示例代码，演示如何使用上述步骤创建 Windows 快捷方式文件：

#include <windows.h>
#include <shobjidl.h>
#include <objbase.h>
#include <string>

int main()
{
    CoInitialize(NULL);

    IShellLink* psl;
    CoCreateInstance(CLSID_ShellLink, NULL, CLSCTX_INPROC_SERVER, IID_IShellLink, (LPVOID*)&psl);

    psl->SetPath(L"C:\\Program Files\\My Program\\start.exe");
    psl->SetArguments(L"/arg1 /arg2");
    psl->SetDescription(L"My Program Shortcut");

    IPersistFile* ppf;
    psl->QueryInterface(IID_IPersistFile, (LPVOID*)&ppf);

    WCHAR wszPath[MAX_PATH];
    MultiByteToWideChar(CP_ACP, 0, "C:\\Users\\Me\\Desktop\\MyShortcut.lnk", -1, wszPath, MAX_PATH);
    ppf->Save(wszPath, TRUE);

    ppf->Release();
    psl->Release();

    CoUninitialize();

    return 0;
}

常见问题解答

• 问：为什么我的快捷方式无法启动目标程序？
  • 答：检查目标路径是否正确且目标程序存在。
• 问：如何创建指向文件夹的快捷方式？
  • 答：使用 Shell_LinkData 结构的 Folder 选项来指向文件夹。
• 问：如何创建带自定义图标的快捷方式？
  • 答：使用 SetIconLocation 函数设置快捷方式的图标。
• 问：如何将快捷方式固定到“开始”菜单？
  • 答：使用 CoInitializeSecurity 函数并调用 IShellLink::SetIDList 函数。
• 问：如何使用 C++ 删除快捷方式文件？
  • 答：使用 SHFileOperation 函数的 FO_DELETE 标志。