Windows查找加载256x256px图标的API技术疑问

问题原因 #

你遇到的加载失败核心原因是：GRPICONDIRENTRY结构体的bWidth/bHeight是BYTE类型（仅8位），Windows资源中约定当图标尺寸为256x256时，这两个字段的值会被存为0，而非256。你的代码直接判断pEntry->bWidth == nSize，当nSize=256时自然匹配失败。

解决方案 #

方案1：修正传统资源解析逻辑 #

修改判断条件，适配256px的约定，同时在创建图标时明确指定尺寸：

#pragma pack(push, 1)
typedef struct  _GRPICONDIRENTRY
{
    BYTE  bWidth;
    BYTE  bHeight;
    BYTE  bColorCount;
    BYTE  bReserved;
    WORD  wPlanes;
    WORD  wBitCount;
    DWORD dwBytesInRes;
    WORD  nId;
} GRPICONDIRENTRY, *PGRPICONDIRENTRY;

typedef struct  _GRPICONDIR
{
    WORD idReserved;
    WORD idType;
    WORD idCount;
    GRPICONDIRENTRY idEntries[1];
} GRPICONDIR, * PGRPICONDIR;
#pragma pack(pop)


HICON Dll2Icon(LPCTSTR szFileName, int nSize)
{
    HICON   hIcon = NULL;
    HMODULE hMod = LoadLibraryEx(szFileName, NULL, LOAD_LIBRARY_AS_DATAFILE | LOAD_LIBRARY_AS_IMAGE_RESOURCE);
    if (!hMod) return NULL;

    HRSRC hResIbIconDir = FindResource(hMod, MAKEINTRESOURCE(42), RT_GROUP_ICON);
    if (!hResIbIconDir) goto Cleanup;

    HGLOBAL hResDatIconDir = LoadResource(hMod, hResIbIconDir);
    if (!hResDatIconDir) goto Cleanup;

    PGRPICONDIR pIconDir = static_cast<PGRPICONDIR>(LockResource(hResDatIconDir));
    if (!pIconDir) goto Cleanup;

    PGRPICONDIRENTRY pEntry;
    for (pEntry = pIconDir->idEntries; pEntry < &(pIconDir->idEntries[pIconDir->idCount]); pEntry++)
    {
        // 适配256px的约定：BYTE值为0代表256
        bool sizeMatch = false;
        if (nSize == 256)
        {
            sizeMatch = (pEntry->bWidth == 0) && (pEntry->bHeight == 0);
        }
        else
        {
            sizeMatch = (pEntry->bWidth == nSize) && (pEntry->bHeight == nSize);
        }

        if (sizeMatch)
        {
            HRSRC hResIbIcon = FindResource(hMod, MAKEINTRESOURCE(pEntry->nId), RT_ICON);
            if (!hResIbIcon) continue;

            HGLOBAL hResDatIcon = LoadResource(hMod, hResIbIcon);
            if (!hResDatIcon) continue;

            PBYTE pIcon = static_cast<PBYTE>(LockResource(hResDatIcon));
            if (!pIcon) { FreeResource(hResDatIcon); continue; }

            // 创建图标时明确指定目标尺寸，而非用0让系统默认缩放
            hIcon = CreateIconFromResourceEx(
                pIcon, 
                pEntry->dwBytesInRes, 
                TRUE, 
                0x00030000, 
                nSize, 
                nSize, 
                LR_DEFAULTCOLOR
            );
            FreeResource(hResDatIcon);
            break;
        }
    }

Cleanup:
    if (hResDatIconDir) FreeResource(hResDatIconDir);
    FreeLibrary(hMod);
    return hIcon;
}

方案2：使用更简便的现代API #

如果不需要手动解析资源结构，推荐使用SHGetFileInfo或ExtractIconEx直接获取指定尺寸的图标，这些API会自动处理256px图标的兼容逻辑：

使用SHGetFileInfo获取图标

#include <shellapi.h>

HICON GetLargeIcon(LPCTSTR szFileName)
{
    SHFILEINFO sfi = {0};
    HICON hIcon = NULL;
    // 使用SHGFI_ICON | SHGFI_LARGEICON获取大图标，Vista+会自动返回256px版本
    if (SHGetFileInfo(szFileName, 0, &sfi, sizeof(sfi), SHGFI_ICON | SHGFI_LARGEICON))
    {
        hIcon = sfi.hIcon;
    }
    return hIcon;
}

使用ExtractIconEx获取指定尺寸图标

#include <shellapi.h>

HICON GetIconBySize(LPCTSTR szFileName, int nSize)
{
    HICON hIcon = NULL;
    UINT count = ExtractIconEx(szFileName, 0, NULL, NULL, 0);
    if (count > 0)
    {
        // 提取指定尺寸的图标，第二个参数为图标索引（0代表第一个）
        ExtractIconEx(szFileName, 0, &hIcon, NULL, 1);
        // 如需调整尺寸，可使用CopyIcon结合ResizeIcon（需要自行实现或使用GDI+）
    }
    return hIcon;
}

关键说明 #

• Windows资源中，256x256的图标在GRPICONDIRENTRY里的bWidth/bHeight字段值为0，这是官方约定的特殊标记
• CreateIconFromResourceEx指定尺寸时，传入256而非0，避免系统对小图标进行拉伸
• 现代API（如SHGetFileInfo）已封装了所有兼容逻辑，无需手动处理资源结构细节

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