winmail.dat是微软outlook/exchange使用tnef封装的二进制容器，含富文本、ole对象、日历邀请等专有数据；因tnef为私有格式且c++标准库无支持，需依赖libtnef等第三方库解析，不可直接读取。
winmail.dat 是什么，为什么不能直接读
winmail.dat 不是普通附件，而是 Microsoft Outlook 使用 TNEF（Transport Neutral Encapsulation Format）封装的二进制容器。它可能包含富文本、内嵌图片、投票按钮、日历邀请等 Outlook 特有数据。标准 MIME 解析器（如 libmime 或 Python 的 email 模块）会把它当作一个不可解析的 application/ms-tnef 二进制 blob，直接跳过或原样保存。
没有现成 C++ 标准库支持，得靠第三方或逆向解析
C++ 标准库完全不提供 TNEF 解析能力。Windows SDK 里也未公开导出相关函数（ExtractTnefAttachment 等属于内部未文档化接口，不可依赖）。可行路径只有两个：
- 调用 Windows COM 接口
IStream+ITnef（仅限 Windows，需安装 Outlook 或 Exchange MAPI 客户端运行时，且ITnef在 Windows 10/11 上已逐步弃用，部分系统注册表缺失会导致CoCreateInstance返回CLASS_NOT_AVAILABLE） - 使用开源 C/C++ 实现：目前最稳定的是 libtnef（C 写的，兼容 C++，MIT 协议），它纯解析不依赖 Outlook，支持提取附件、正文（RTF/HTML）、发件人信息等
别试图手写解析——TNEF 是带校验和、嵌套属性块（ATTR）、可变长度编码的二进制格式，头部 magic 是 0x223e9f78，但属性 ID（如 MAPI_ATTACH_DATA_BIN 对应附件内容）需查 MAPI 规范，极易出错。
用 libtnef 解析 winmail.dat 的最小可行步骤
以 Ubuntu 22.04 + g++ 11 为例（Windows 下可用 vcpkg 安装 libtnef）：
1. 安装：sudo apt install libtnef-dev（或从源码编译，注意启用 --with-cxx）
2. 关键函数是 tnef_parse_file()，它返回 TNEFStruct*，所有内容都在 attachments 链表和 properties 数组里：
#include <tnef.h>
TNEFStruct* t = tnef_parse_file("winmail.dat");
if (!t) {
// 错误：可能是非 TNEF 文件，或损坏，错误码在 tnef_errno 中
fprintf(stderr, "parse failed: %s\n", tnef_strerror(tnef_errno));
return -1;
}
// 遍历附件
for (Attachment* a = t->attachments; a; a = a->next) {
printf("name: %s, size: %zu\n", a->name, a->size);
FILE* f = fopen(a->name, "wb");
if (f) {
fwrite(a->data, 1, a->size, f);
fclose(f);
}
}
tnef_free(t);
</tnef.h>
注意点：
-
tnef_parse_file()不自动解码 RTF → HTML；若需正文，要检查t->properties中MAPI_BODY_RTF属性，再用独立 RTF 库（如librtf）转换 - 附件名可能含 Windows 路径分隔符
\或 Unicode，a->name是 Latin-1 编码（不是 UTF-8），需按MAPI_ATTACH_LONG_FILENAME属性里的原始 Unicode 字段（PROP_TYPE_UNICODE）提取才可靠 - 大文件（>50MB）可能触发
tnef默认内存限制，需在调用前设tnef_set_max_size(100 * 1024 * 1024)
常见失败场景和绕过方式
遇到 tnef_parse_file 返回 NULL 但 tnef_strerror 显示 "Invalid TNEF signature"？大概率是：
- 邮件网关（如 Proofpoint、Barracuda）已提前剥离或转义
winmail.dat，实际收到的是空文件或 base64 解码后被截断——先用file winmail.dat确认是否真为 TNEF（输出含TNEF字样） - Outlook 发送时勾选了
“将邮件发送为纯文本”，此时不会生成winmail.dat，但某些旧版客户端仍会附上空壳，导致解析失败 - 附件被重命名（如
winmail.dat?att=1），但内容仍是 TNEF —— 只要文件头正确，tnef_parse_file不关心扩展名
真正麻烦的是混合 MIME + TNEF 场景：一封邮件同时含 base64 编码的普通附件和一个 winmail.dat。这时必须先用 MIME 解析器（如 gmime 或 libmailutils）定位到 application/ms-tnef part，再把该 part 的原始字节喂给 tnef_parse_buffer()，而不是直接解析整个 .eml 文件。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
