xmail/pop3_message

bool xrtPop3ClientRetrWrite( xpop3client* pClient, uint64 iMessage, size_t iMaxBytes, xmailwriteproc pWrite, ptr pUserData, size_t* pWritten, xdeadline iDeadline, xcancel* pCancel );

/* 流式读取完整邮件并恢复每一行的 CRLF；零预算使用默认上限。 */
result = xrtPop3ClientRetrWrite(pClient, iMessage, iMaxBytes, pWrite, pUserData, pWritten, iDeadline, pCancel);

bool xrtPop3ClientTopWrite( xpop3client* pClient, uint64 iMessage, uint64 iLines, size_t iMaxBytes, xmailwriteproc pWrite, ptr pUserData, size_t* pWritten, xdeadline iDeadline, xcancel* pCancel );

/* 流式读取字段和指定数量正文行，并恢复每一行的 CRLF。 */
result = xrtPop3ClientTopWrite(pClient, iMessage, iLines, iMaxBytes, pWrite, pUserData, pWritten, iDeadline, pCancel);

bytes xrtPop3ClientRetrBytes( xpop3client* pClient, uint64 iMessage, size_t iMaxBytes, size_t* pOutputSize, xdeadline iDeadline, xcancel* pCancel );

/* 读取完整邮件并返回由 xrtFree 释放、末尾附零的连续字节。 */
result = xrtPop3ClientRetrBytes(pClient, iMessage, iMaxBytes, pOutputSize, iDeadline, pCancel);

bytes xrtPop3ClientTopBytes( xpop3client* pClient, uint64 iMessage, uint64 iLines, size_t iMaxBytes, size_t* pOutputSize, xdeadline iDeadline, xcancel* pCancel );

/* 读取 TOP 结果并返回由 xrtFree 释放、末尾附零的连续字节。 */
result = xrtPop3ClientTopBytes(pClient, iMessage, iLines, iMaxBytes, pOutputSize, iDeadline, pCancel);

bool xrtPop3ClientRetrTree( xpop3client* pClient, uint64 iMessage, const xmailtreelimits* pLimits, xmailtree* pTree, xdeadline iDeadline, xcancel* pCancel );

/* 按 MIME 树预算读取并解析完整邮件；成功结果不依赖网络缓冲。 */
result = xrtPop3ClientRetrTree(pClient, iMessage, pLimits, pTree, iDeadline, pCancel);