使用SLDF_HAS_RELPATH标志在C++创建相对路径快捷方式失败求助

问题背景 #

研究创建相对路径快捷方式时，发现多数在线方案使用%COMSPEC% /c start .\something.exe这类变通方法。后来找到相关技术问答，得知Windows原生支持带相对路径的快捷方式，只需设置SLDF_HAS_RELPATH标志并写入快捷方式二进制文件。但将原方案中的NSIS脚本移植为C++代码后，生成的快捷方式无法工作：属性面板显示无目标路径，调用GetShortcutTarget函数也无法获取目标，尽管二进制文件中确实存在目标路径，且目标文件真实存在。

当前代码的问题 #

手动构造.lnk二进制文件的方式极易出错，因为Windows快捷文件格式包含多个严格的结构字段（如偏移量、长度校验、额外属性块等），当前代码缺失了部分关键结构或字段值不正确，导致系统无法正确解析该快捷方式。

正确解决方案：使用IShellLink COM接口 #

Windows提供的IShellLink接口原生支持创建相对路径快捷方式，无需手动操作二进制文件。只需调用SetRelativePath方法，并确保快捷方式保存时的路径正确，系统会自动处理相对路径的标识和存储。

修正后的代码 #

#include <iostream>
#include <string>
#include <windows.h>
#include <shlobj_core.h>
#include <objbase.h>
#include <atlbase.h>

// 使用IShellLink创建相对路径快捷方式
HRESULT CreateRelativeShortcut(const std::wstring& shortcutPath, const std::wstring& relativeTargetPath) {
    HRESULT hres = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
    if (FAILED(hres)) return hres;

    CComPtr<IShellLink> psl;
    hres = CoCreateInstance(CLSID_ShellLink, NULL, CLSCTX_INPROC_SERVER, IID_IShellLink, (void**)&psl);
    if (FAILED(hres)) {
        CoUninitialize();
        return hres;
    }

    // 设置相对目标路径，自动启用SLDF_HAS_RELPATH标志
    hres = psl->SetRelativePath(relativeTargetPath.c_str(), SLDF_HAS_RELPATH);
    if (FAILED(hres)) {
        CoUninitialize();
        return hres;
    }

    // 可选：设置快捷方式的工作目录（若需要）
    // psl->SetWorkingDirectory(L".");

    // 获取IPersistFile接口用于保存快捷方式
    CComPtr<IPersistFile> ppf;
    hres = psl->QueryInterface(IID_IPersistFile, (void**)&ppf);
    if (FAILED(hres)) {
        CoUninitialize();
        return hres;
    }

    // 保存快捷方式到指定路径
    hres = ppf->Save(shortcutPath.c_str(), TRUE);

    CoUninitialize();
    return hres;
}

// 获取快捷方式的目标路径（支持相对路径）
HRESULT GetShortcutTarget(const std::wstring& shortcutPath, std::wstring& targetPath) {
    HRESULT hres = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
    if (FAILED(hres)) return hres;

    CComPtr<IShellLink> psl;
    hres = CoCreateInstance(CLSID_ShellLink, NULL, CLSCTX_INPROC_SERVER, IID_IShellLink, (void**)&psl);
    if (FAILED(hres)) {
        CoUninitialize();
        return hres;
    }

    CComPtr<IPersistFile> ppf;
    hres = psl->QueryInterface(IID_IPersistFile, (void**)&ppf);
    if (FAILED(hres)) {
        CoUninitialize();
        return hres;
    }

    // 加载快捷方式文件
    hres = ppf->Load(shortcutPath.c_str(), STGM_READ);
    if (FAILED(hres)) {
        CoUninitialize();
        return hres;
    }

    WCHAR path[MAX_PATH];
    // 使用SLGP_RELATIVE_ONLY标志获取相对路径
    hres = psl->GetPath(path, MAX_PATH, NULL, SLGP_RELATIVE_ONLY);
    if (SUCCEEDED(hres)) {
        targetPath = path;
    }

    CoUninitialize();
    return hres;
}

int main() {
    std::wstring outputFile = L"example.lnk";
    std::wstring relativePath = L"..\\target\\application.exe";

    HRESULT hres = CreateRelativeShortcut(outputFile, relativePath);
    if (SUCCEEDED(hres)) {
        std::wcout << L"快捷方式创建成功: " << outputFile << std::endl;

        std::wstring target;
        hres = GetShortcutTarget(outputFile, target);
        if (SUCCEEDED(hres)) {
            std::wcout << L"快捷方式目标路径: " << target << std::endl;
        } else {
            std::wcerr << L"获取目标路径失败，错误码: " << hres << std::endl;
        }
    } else {
        std::wcerr << L"创建快捷方式失败，错误码: " << hres << std::endl;
    }

    return 0;
}

关键说明 #

• 使用IShellLink::SetRelativePath方法直接设置相对路径，系统会自动处理SLDF_HAS_RELPATH标志及二进制结构，避免手动构造的错误。
• 保存快捷方式时，shortcutPath需为绝对路径，或确保当前工作目录正确，以便系统正确计算快捷方式与目标文件的相对位置。
• 获取目标路径时使用SLGP_RELATIVE_ONLY标志，可直接返回原始的相对路径字符串，而非解析后的绝对路径。

内容的提问来源于stack exchange，提问作者Uladzimir