Windows 安裝程式常需在桌面與開始選單建立捷徑。標準做法是使用 **Shell Link COM 介面** (`IShellLink`, `IPersistFile`),而非單純寫入 `.lnk` 檔案。本文提供完整、可編譯的 MFC/Win32 程式碼。
#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
});
}
使用 `IShellLink` + `IPersistFile` 是 Windows 建立捷徑的標準、穩健方式。封裝 `CreateShortcut()` 並搭配 `SHGetSpecialFolderPath` 取得正確特殊資料夾路徑,即可在安裝程式中可靠建立桌面與開始選單捷徑。