xmail/imap_client

返回：初始化 IMAP 143 端口、64 KiB 命令/响应行和 XRT 网络默认值。

imapclientconfiginit obj;
xrtImapClientConfigInit(&obj);

返回：验证网络所有者、线路上限和命令上限。

/* 验证网络所有者、线路上限和命令上限。 */
result = xrtImapClientConfigValid(pConfig);

返回：建立连接，读取 greeting，完成 CAPABILITY 和可选 STARTTLS。

/* 建立连接，读取 greeting，完成 CAPABILITY 和可选 STARTTLS。 */
result = xrtImapClientOpen(pConfig, iDeadline, pCancel);

返回：返回当前 IMAP 协议层级或终态。

/* 返回当前 IMAP 协议层级或终态。 */
result = xrtImapClientState(pClient);

返回：返回最近一次 CAPABILITY 快照中的已知能力位。

/* 返回最近一次 CAPABILITY 快照中的已知能力位。 */
result = xrtImapClientCapabilities(pClient);

返回：返回当前会话实际使用的明文或 TLS 传输安全级别。

/* 返回当前会话实际使用的明文或 TLS 传输安全级别。 */
result = xrtImapClientSecurity(pClient);

返回：返回顺序命令当前使用的自动 tag；没有活动命令时返回空视图。

/* 返回顺序命令当前使用的自动 tag；没有活动命令时返回空视图。 */
result = xrtImapClientTag(pClient);

返回：返回当前服务器 literal 尚未读取的字节数。

/* 返回当前服务器 literal 尚未读取的字节数。 */
result = xrtImapClientLiteralRemaining(pClient);

返回：返回当前命令行总长度上限。

/* 返回当前命令行总长度上限。 */
result = xrtImapClientCommandLimit(pClient);

返回：返回 CAPABILITY 声明的全局 APPEND 上限，未知或按邮箱决定时返回 UNKNOWN。

/* 返回 CAPABILITY 声明的全局 APPEND 上限，未知或按邮箱决定时返回 UNKNOWN。 */
result = xrtImapClientAppendLimit(pClient);

返回：返回最近 greeting 或 tagged completion 的稳定借用视图。

/* 返回最近 greeting 或 tagged completion 的稳定借用视图。 */
result = xrtImapClientLastResponse(pClient, pResponse);

返回：XRT_API bool xrtImapClientSend( ximapclient* pClient, xstrview Tag, xstrview Command, xstrview Arguments, xdeadline iDeadline, xcancel* pCancel );

/* XRT_API bool xrtImapClientSend( ximapclient* pClient, xstrview Tag, xstrview Command, xstrview Arguments, xdeadline iDeadline, xcancel* pCancel ); */
result = xrtImapClientSend();

返回：XRT_API bool xrtImapClientSendParts( ximapclient* pClient, xstrview Tag, xstrview Command, const xstrview* pArguments, size_t iCount, xdeadline iDeadline, xcancel* pCancel );

/* XRT_API bool xrtImapClientSendParts( ximapclient* pClient, xstrview Tag, xstrview Command, const xstrview* pArguments, size_t iCount, xdeadline iDeadline, xcancel* pCancel ); */
result = xrtImapClientSendParts();

返回：发送原始命令续传字节，用于 APPEND literal 等协议扩展。

/* 发送原始命令续传字节，用于 APPEND literal 等协议扩展。 */
result = xrtImapClientWrite(pClient, pData, iSize, iDeadline, pCancel);

返回：发送一条不带 tag 的 continuation 数据并自动追加 CRLF。

/* 发送一条不带 tag 的 continuation 数据并自动追加 CRLF。 */
result = xrtImapClientContinue(pClient, Data, iDeadline, pCancel);

返回：XRT_API bool xrtImapClientReceive( ximapclient* pClient, ximapevent* pEvent, xdeadline iDeadline, xcancel* pCancel );

/* XRT_API bool xrtImapClientReceive( ximapclient* pClient, ximapevent* pEvent, xdeadline iDeadline, xcancel* pCancel ); */
result = xrtImapClientReceive();

返回：把当前 literal 的下一段读入调用方缓冲区，Read 返回实际读取量。

/* 把当前 literal 的下一段读入调用方缓冲区，Read 返回实际读取量。 */
result = xrtImapClientReadLiteral(pClient, pBuffer, iCapacity, pRead, iDeadline, pCancel);

返回：生成唯一 tag 并开始一个顺序命令。

/* 生成唯一 tag 并开始一个顺序命令。 */
result = xrtImapClientBegin(pClient, Command, Arguments, iDeadline, pCancel);

返回：生成唯一 tag 并以零拼接方式开始多参数顺序命令。

/* 生成唯一 tag 并以零拼接方式开始多参数顺序命令。 */
result = xrtImapClientBeginParts(pClient, Command, pArguments, iCount, iDeadline, pCancel);

返回：XRT_API xmailnext xrtImapClientNext( ximapclient* pClient, ximapevent* pEvent, xdeadline iDeadline, xcancel* pCancel );

/* XRT_API xmailnext xrtImapClientNext( ximapclient* pClient, ximapevent* pEvent, xdeadline iDeadline, xcancel* pCancel ); */
result = xrtImapClientNext();

返回：在没有活动顺序命令时重新获取并替换 CAPABILITY 快照。

/* 在没有活动顺序命令时重新获取并替换 CAPABILITY 快照。 */
result = xrtImapClientRefresh(pClient, iDeadline, pCancel);

返回：发送 LOGOUT，消费 BYE 和 tagged completion，并正常关闭传输。

/* 发送 LOGOUT，消费 BYE 和 tagged completion，并正常关闭传输。 */
result = xrtImapClientLogout(pClient, iDeadline, pCancel);

返回：不发送 LOGOUT，直接正常关闭传输。

/* 不发送 LOGOUT，直接正常关闭传输。 */
result = xrtImapClientClose(pClient, iDeadline);

返回：立即异常中止连接；重复调用成功，FAILED 状态保留到销毁。

/* 立即异常中止连接；重复调用成功，FAILED 状态保留到销毁。 */
result = xrtImapClientAbort(pClient);

返回：释放客户端；尚未关闭时执行异常中止。

xrtImapClientDestroy(pClient);