萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C++ 建立桌面捷徑與開始選單捷徑完整實作 (Shell Link API)

前言

Windows 安裝程式常需在桌面與開始選單建立捷徑。標準做法是使用 **Shell Link COM 介面** (`IShellLink`, `IPersistFile`),而非單純寫入 `.lnk` 檔案。本文提供完整、可編譯的 MFC/Win32 程式碼。

核心 API 流程

  1. `CoInitialize(NULL)` 初始化 COM 庫。
  2. `CoCreateInstance(CLSID_ShellLink, ..., IID_IShellLink, ...)` 建立 Shell Link 物件。
  3. `IShellLink::SetPath()` 設定目標執行檔路徑。
  4. `IShellLink::SetIconLocation()` 設定圖示 (選填)。
  5. `IShellLink::SetWorkingDirectory()` 設定工作目錄。
  6. `QueryInterface(IID_IPersistFile)` 取得持久化介面。
  7. `IPersistFile::Save()` 將捷徑儲存至 `.lnk` 檔案。
  8. `Release()` 釋放介面,`CoUninitialize()` 釋放 COM。

通用建立捷徑函式


#include 
#include 
#include 
#pragma comment(lib, "ole32.lib")
#pragma comment(lib, "uuid.lib")

HRESULT CreateShortcut(LPCTSTR pszLinkPath, LPCTSTR pszTargetPath, LPCTSTR pszIconPath = NULL, int iIconIndex = 0)
{
    HRESULT hr = CoInitialize(NULL);
    if (FAILED(hr)) return hr;

    IShellLink* psl = NULL;
    hr = CoCreateInstance(CLSID_ShellLink, NULL, CLSCTX_INPROC_SERVER, IID_IShellLink, (void**)&psl);
    if (SUCCEEDED(hr))
    {
        psl->SetPath(pszTargetPath);
        if (pszIconPath && PathFileExists(pszIconPath))
            psl->SetIconLocation(pszIconPath, iIconIndex);

        // 可選:設定熱鍵、工作目錄、描述等
        // psl->SetHotkey(MAKEWORD('R', HOTKEYF_CONTROL | HOTKEYF_SHIFT));
        TCHAR szWorkDir[MAX_PATH];
        StringCchCopy(szWorkDir, MAX_PATH, pszTargetPath);
        PathRemoveFileSpec(szWorkDir);
        psl->SetWorkingDirectory(szWorkDir);

        IPersistFile* ppf = NULL;
        hr = psl->QueryInterface(IID_IPersistFile, (void**)&ppf);
        if (SUCCEEDED(hr))
        {
            hr = ppf->Save(pszLinkPath, TRUE); // TRUE = 覆寫既有檔案
            ppf->Release();
        }
        psl->Release();
    }
    CoUninitialize();
    return hr;
}

取得特殊資料夾路徑 (桌面、開始選單)


// 取得「所有使用者」的開始選單\程式集 資料夾
TCHAR szStartMenu[MAX_PATH];
SHGetSpecialFolderPath(NULL, szStartMenu, CSIDL_COMMON_PROGRAMS, FALSE); // 或 CSIDL_PROGRAMS (當前使用者)

// 取得桌面
TCHAR szDesktop[MAX_PATH];
SHGetSpecialFolderPath(NULL, szDesktop, CSIDL_COMMON_DESKTOPDIRECTORY, FALSE); // 或 CSIDL_DESKTOPDIRECTORY

常用 CSIDL 常數:`CSIDL_DESKTOP` (當前使用者桌面)、`CSIDL_COMMON_DESKTOPDIRECTORY` (所有使用者桌面)、`CSIDL_PROGRAMS` (當前使用者開始選單)、`CSIDL_COMMON_PROGRAMS` (所有使用者開始選單)。

完整安裝程式範例:建立應用程式與解除安裝捷徑


void CreateStartMenuShortcuts(LPCTSTR pszInstallDir)
{
    TCHAR szStartMenu[MAX_PATH];
    SHGetSpecialFolderPath(NULL, szStartMenu, CSIDL_COMMON_PROGRAMS, FALSE);

    // 建立子資料夾:開始選單\程式集\MyApp
    TCHAR szAppFolder[MAX_PATH];
    PathCombine(szAppFolder, szStartMenu, TEXT("MyApp"));
    SHCreateDirectoryEx(NULL, szAppFolder, NULL);

    // 目標執行檔與圖示
    TCHAR szExe[MAX_PATH], szUninst[MAX_PATH], szExeIco[MAX_PATH], szUninstIco[MAX_PATH];
    PathCombine(szExe,      pszInstallDir, TEXT("MyApp.exe"));
    PathCombine(szUninst,   pszInstallDir, TEXT("Uninstall.exe"));
    PathCombine(szExeIco,   pszInstallDir, TEXT("MyApp.ico"));
    PathCombine(szUninstIco,pszInstallDir, TEXT("Uninst.ico"));

    // 捷徑完整路徑
    TCHAR szLink1[MAX_PATH], szLink2[MAX_PATH];
    PathCombine(szLink1, szAppFolder, TEXT("MyApp.lnk"));
    PathCombine(szLink2, szAppFolder, TEXT("Uninstall.lnk"));

    // 建立捷徑
    CreateShortcut(szLink1, szExe, szExeIco);
    CreateShortcut(szLink2, szUninst, szUninstIco);
}

刪除捷徑 (解除安裝時)


void RemoveStartMenuShortcuts()
{
    TCHAR szStartMenu[MAX_PATH];
    SHGetSpecialFolderPath(NULL, szStartMenu, CSIDL_COMMON_PROGRAMS, FALSE);
    TCHAR szAppFolder[MAX_PATH];
    PathCombine(szAppFolder, szStartMenu, TEXT("MyApp"));

    // 遞刪整個資料夾
    SHFileOperation(&(SHFILEOPSTRUCT){
        .hwnd = NULL, .wFunc = FO_DELETE,
        .pFrom = szAppFolder, .fFlags = FOF_NOCONFIRMATION | FOF_SILENT
    });
}

注意事項

  • 權限:寫入「所有使用者」桌面/開始選單需**系統管理員權限** (UAC 提升)。
  • Unicode/ANSI:建議專案設定為 Unicode (`UNICODE`, `_UNICODE`),使用 `TCHAR`/`LPCTSTR` 宏自動適配。
  • 路徑長度:使用 `MAX_PATH` (260) 緩衝區,長路徑需加 `\\?\` 前綴或使用 `SHGetKnownFolderPath` (Vista+)。
  • 圖示索引:`SetIconLocation` 的第二參數為圖示資源索引 (0 為第一個)。

總結

使用 `IShellLink` + `IPersistFile` 是 Windows 建立捷徑的標準、穩健方式。封裝 `CreateShortcut()` 並搭配 `SHGetSpecialFolderPath` 取得正確特殊資料夾路徑,即可在安裝程式中可靠建立桌面與開始選單捷徑。

copyright © 萬盛學電腦網 all rights reserved