// Pop3.h: interface for the CPop3 class.
//
//////////////////////////////////////////////////////////////////////

#if !defined(AFX_POP3_H__C7D744E6_CB2C_44AC_9E1D_71D0D9F1D1CC__INCLUDED_)
#define AFX_POP3_H__C7D744E6_CB2C_44AC_9E1D_71D0D9F1D1CC__INCLUDED_

#include "Pop3Socket.h"	// Added by ClassView
#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

class CPop3  
{
public:
	BOOL Reset(void);
	// 獲得郵件主題
	LPCTSTR GetMailHeader(UINT nIndex);
	// 發送NOOP命令，進行一次空操作
	BOOL Noop(void);
	// 獲得出錯信息
	LPCTSTR GetErrorString(void);
	// 發送STAT命令，獲得郵件總體的狀態信息
	BOOL GetState(void);
	// 發送LIST命令，獲得郵件的具體狀態信息
	BOOL List(void);
	// 發送RETR命令，接收郵件正文
	BOOL RetrieveMail(UINT nIndex,CString &strMsg);
	// 發送DELE命令，將所選郵件標記為刪除
	BOOL Delete(UINT nIndex);
	// 發送TOP命令，獲得所有的郵件主題
	BOOL ListHeader(void);
	// 私有變量接口函數，返回給定索引的郵件大小
	DWORD GetMsgSize(UINT nID);
	// 私有變量接口函數，返回郵件數目
	UINT GetMailCount(void) const;
	// 發送命令
	BOOL Send(LPCTSTR lpszSend,UINT nLength);
	// 斷開連接，發送QUIT命令，并請求真正刪除所要求的郵件
	BOOL Disconnect(void);
	// 建立與服務器的連接，其中包括登錄的過程
	BOOL Connect(LPCTSTR strAddress,LPCTSTR strUser,LPCTSTR strPassword,UINT nPort = 110);
	CPop3();
	virtual ~CPop3();

protected:
	// 所有郵件的總體大小
	UINT m_nSize;
	// 通信的套接字
	SOCKET m_sock;
	// 郵件數目，以GetMailCount為接口函數
	UINT m_nMails;
	// 記錄是否發送過有效的LIST命令
	BOOL m_bList;
	// 記錄是否發送過有效的STAT命令
	BOOL m_bState;
	// 記錄每個郵件大小的MFC數組變量
	CDWordArray m_arSizes;
	// 記錄每個郵件主題的MFC數組變量
	CStringArray m_arHeaders;
	// 記錄是否已經與服務器建立連接
	BOOL m_bConnected;
	// 記錄回應的消息
	CString m_sResponse;
	// 確定是否超時，只要用去的時間超過該值就表示超時
	// 應該采取相應措施
	DWORD m_dwTimeout;

private:
	// 記錄出錯信息，以GetErrorString為接口函數
	CString m_sError;
	// 去除開頭的+OK標識，獲得回應的有效信息
	// 從返回的信息中提取數目和大小信息，主要用于LIST命令的回應信息
	BOOL ParseNumAndSize(UINT &nNum,UINT &nSize,LPCTSTR lpszBuf,UINT &nEnd);
	// 讀取回應信息，與GetResponse函數不同，它進行實際的工作
	BOOL ReadResponse(TCHAR *pChar,UINT nSize,BOOL bDouble);
	BOOL GetResponse(void);
	// 讀取針對LIST命令的返回信息
	// 由于對LIST命令的返回信息較特殊，所以用單獨的函數
	BOOL ReadList(void);
	// 對STAT命令的返回信息，原因同上
	BOOL ReadState(void);
};

#endif // !defined(AFX_POP3_H__C7D744E6_CB2C_44AC_9E1D_71D0D9F1D1CC__INCLUDED_)