get_stock_icon.py

def get_stock_icon(icon_id: int) -> Image.Image | None:
    """Get a Windows stock icon by its SHSTOCKICONID value.

    Args:
        icon_id: Stock icon ID from SHSTOCKICONID enum
                 Example values:
                 - 31 (SIID_RECYCLER): Empty recycle bin
                 - 32 (SIID_RECYCLERFULL): Full recycle bin
                 See: https://learn.microsoft.com/en-us/windows/win32/api/shellapi/ne-shellapi-shstockiconid

    Returns:
        PIL Image of the stock icon, or None if retrieval fails
    """
    try:
        import ctypes
        from ctypes import wintypes

        class SHSTOCKICONINFO(ctypes.Structure):
            _fields_ = [
                ("cbSize", wintypes.DWORD),
                ("hIcon", wintypes.HICON),
                ("iSysImageIndex", ctypes.c_int),
                ("iIcon", ctypes.c_int),
                ("szPath", wintypes.WCHAR * 260),
            ]

        # SHGSI flags - must include SHGSI_ICON to request icon handle
        SHGSI_ICON = 0x000000100  # Return icon handle (required)
        SHGSI_LARGEICON = 0x000000000  # Large icon (default size)

        # Must use SHGSI_ICON to get icon handle, combined with size preference
        flags = SHGSI_ICON | SHGSI_LARGEICON

        sii = SHSTOCKICONINFO()
        sii.cbSize = ctypes.sizeof(sii)

        # Get the stock icon
        result = ctypes.windll.shell32.SHGetStockIconInfo(icon_id, flags, ctypes.byref(sii))
        if result != 0 or not sii.hIcon:
            return None

        try:
            # Convert HICON to PIL Image using existing helper
            icon_img = hicon_to_image(sii.hIcon)
            return icon_img
        finally:
            try:
                win32gui.DestroyIcon(sii.hIcon)
            except Exception:
                pass

    except Exception as e:
        logging.error(f"Error getting stock icon {icon_id}: {e}")
        return None