【正文】 )。 //查詢該實現(xiàn)中 UI(user interface)的可用性 第 9章 高級網(wǎng)絡編程 API cmcStatus=cmc_query_configuration( 0， //沒有會話句柄 CMC_CONFIG_UI_AVAIL， //該參數(shù)用來查詢 UI的可用性 (void*)amp。 第 9章 高級網(wǎng)絡編程 API 開始對話的過程就是初始化 CMC的過程 ， 下面我們舉一個實例來說明對話過程的開始和結束 。 CMC_buffer item_reference。 第 9章 高級網(wǎng)絡編程 API 2． CMC定義的標志 在 CMC中定義了各種類型的標志 ， 這些標志廣泛使用在后面介紹的 CMC函數(shù)中 。 第 9章 高級網(wǎng)絡編程 API typedef CMC_uint16 CMC_boolean。對于每一個CDocument類，應該增加如下所示的消息映射項： 第 9章 高級網(wǎng)絡編程 API ON_COMMAND(ID_FILE_SEND_MAIL,OnFileSendMail) ON_UPDATE_COMMAND_UI(ID_FILE_SEND_MAIL,OnUpdateFileSendMail) 增加后的程序為 BEGIN_MESSAGE_MAP(CMapi1Doc, CDocument) //{{AFX_MSG_MAP(CMapi1Doc) // NOTE the ClassWizard will add and remove mapping macros here. 第 9章 高級網(wǎng)絡編程 API // DO NOT EDIT what you see in these blocks of generated code! //}}AFX_MSG_MAP ON_COMMAND(ID_FILE_SEND_MAIL, OnFileSendMail) ON_UPDATE_COMMAND_UI(ID_FILE_SEND_MAIL, OnUpdateFileSendMail) END_MESSAGE_MAP(?) 第 9章 高級網(wǎng)絡編程 API MAPI的高級應用 目前存在以下 4種 MAPI的客戶接口。 若在創(chuàng)建工程時沒有選擇 MAPI選項 ， 則可以通過手工的方式增加 MAPI功能 。 IsBlocking(?)函數(shù)調(diào)用后返回一個布爾值 ， 作用為判斷在當前時刻套接口是否處于阻塞狀態(tài) ， 即是否在等待某種事件的發(fā)送 。 第 9章 高級網(wǎng)絡編程 API 該函數(shù)的默認套接口類型是 SOCK_STREAM， 即流式套接口 ， 當然在程序中我們還可以使用數(shù)據(jù)報套接口SOCK_DGRAM。 } // This listening socket has been constructed // in the primary thread. 第 9章 高級網(wǎng)絡編程 API void CListeningSocket::OnAccept(int nErrorCode) { // This CSocket object is used just temporarily // to accept the ining connection. CSocket sConnected。 第 9章 高級網(wǎng)絡編程 API 1． Attach( )函數(shù) Attach(?)函數(shù)格式如下： BOOL Attach( SOCKET hSocket )。 該函數(shù)用于向無連接的遠程套接口發(fā)送數(shù)據(jù) 。 rSocketAddress, ?UINTamp。 AfxMessageBox (szError)。 舉例說明如下： // CMyAsyncSocket是 CAsyncSocket派生類并定義如下變量 // CString m_sendBuffer。 } 第 9章 高級網(wǎng)絡編程 API break。 i++。 該函數(shù)是一個需要重載的回調(diào)函數(shù) ， 當一個套接口關閉時 ， 可以調(diào)用此函數(shù)處理相應的消息 。 該函數(shù)用于設置套接口的工作模式。 13． GetSockOpt( )函數(shù) GetSockOpt(?)函數(shù)格式如下： BOOL GetSockOpt( int nOptionName, void* lpOptionValue, ? ?int* lpOptionLen, int nLevel = SOL_SOCKET )。 第 9章 高級網(wǎng)絡編程 API 對于指定的套接口調(diào)用 GetPeerName(?)函數(shù) ， 就可以返回與之對應的遠程套接口的 IP地址和端口號 。 該函數(shù)的 hSocket參數(shù)指定一個套接口的句柄 ， 其作用是返回與此套接口關聯(lián)的 CAsyncSocket對象的指針 。 函數(shù)的第 二個參 數(shù) nSocketType 用來 指定是 流式(SOCK_STREAM)還是數(shù)據(jù)報式 (SOCK_DGRAM)套接口 。 該函數(shù)用于建立與遠程套接口的連接 。 該函數(shù)用于建立一個本地地址與一個套接口的關聯(lián)，即綁定。 第 9章 高級網(wǎng)絡編程 API 2． AsyncSelect( )函數(shù) AsyncSelect(?)函數(shù)格式如下： BOOL AsyncSelect(long lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE )。 CAsyncSocket類定義了一組非常有用的成員函數(shù)，這些函數(shù)的功能和格式與前幾章介紹的函數(shù)相同或類似，故下面只進行一些簡單的說明。 第 9章 高級網(wǎng)絡編程 API 表 91 網(wǎng)絡事件的數(shù)值 網(wǎng)絡事件類型 對應的數(shù)值 F D _ RE A D 0x01 F D _ W RIT E 0x02 F D _ O O B 0x04 F D _ A CCE P T 0x08 F D _ CO N N E CT 0x10 F D _ CL O S E 0x20 第 9章 高級網(wǎng)絡編程 API 3． Attach( )函數(shù) Attach(?)函數(shù)格式如下： BOOL Attach(SOCKET hSocket, long lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE )。 該函數(shù)用于關閉套接口 ， 釋放與套接口有關的系統(tǒng)資源 。 在調(diào)用 CAsyncSocket的構造函數(shù)創(chuàng)建了 CAsyncSocket對象后 ， 需要調(diào)用 Create(?)函數(shù)來創(chuàng)建底層的套接口 。 最后一個參數(shù) lpszSocketAddress允許我們?yōu)樘捉涌谥付ㄒ粋€網(wǎng)絡地址 ， 其默認值為 0， 表示套接口的地址將限定為本地機 。 在實際應用中 ， 當調(diào)用的操作失敗后使用該函數(shù)返回套接口的錯誤代碼 。 rSocketAddress, UINTamp。 該函數(shù)僅支持SOL_SOCKET和 IPPROTO_TCP兩個選項級別 。 參數(shù) nConnectionBacklog的取值區(qū)間為 1～ 5， 默認值為 5，它指出正在等待連接的最大隊列長度 。 第 9章 高級網(wǎng)絡編程 API 20． OnOutOfBandData(?)函數(shù) OnOutOfBandData(?)函數(shù)格式如下： virtual void OnOutOfBandData( int nErrorCode )。 nRead = Receive(buff, 4096)。 m_strRecv += szTemp。 第 9章 高級網(wǎng)絡編程 API void CMyAsyncSocket ::OnSend(int nErrorCode) { while (m_nBytesSent m_nBytesBufferSize) { int dwBytes。 m_sendBuffer = 。 該函數(shù)用于從無連接的遠程套接口上讀取數(shù)據(jù)報信息 。 因此 ， 可以將 ShutDown(?)的功能理解為對接收或發(fā)送功能的關閉 ， 具體的控制模式有三種 ， 如表 92所示 。 // ... class CSockThread : public CWinThread { // ... Other function and member declarations protected: CSocket m_sConnected。 // After detaching it, it should no longer be // used in the context of this thread. // Start the other thread. AfxBeginThread(RUNTIME_CLASS(CSockThread))。 地址的默認值為 NULL， 指出套接口被創(chuàng)建時使用 INADDR_ANY。 第 9章 高級網(wǎng)絡編程 API 6． OnMessagePending( )函數(shù) OnMessagePending(?)函數(shù)格式如下： virtual BOOL OnMessagePending(?)。 第 9章 高級網(wǎng)絡編程 API 圖 93 郵件處理窗口 第 9章 高級網(wǎng)絡編程 API 2． 使用 MAPI組件 如果已經(jīng)創(chuàng)建好了一個項目 ， 但在項目中并沒有使用 MAPI ， 則 可 以 使 用 VC++ 的 Project?|?Add to Project?|?Commonents and Controls菜單命令 (在中文環(huán)境下為 “ 工程 ” ｜ “ 添加工程 ” ｜ Commonents and Controls)， 彈出如圖 94所示的對話框 ， 雙擊 Visual C++ Components， 從彈出的對話框中選擇 MAPI組件即可 。 typedef long int CMC_sint32。 typedef CMC_uint32 CMC_flags。cmc_logon(?)函數(shù)的調(diào)用格式如下： 第 9章 高級網(wǎng)絡編程 API CMC_return_code cmc_logon( CMC_string service, CMC_string user, CMC_string password, CMC_object_identifier character_set, CMC_ui_id ui_id, CMC_uint16 caller_cmc_version, CMC_flags logon_flags, CMC_session_id FAR *session, CMC_extension FAR *logon_extensions )。 第 9章 高級網(wǎng)絡編程 API 該結構的最后一個字段 extension_flags使用時要注意 ， 它設置為 CMC_EXT_LAST_ELEMENT時 ， 表示是結構數(shù)據(jù)中的最后一個結構 。39。39。 if(cmcStatus!=CMC_SUCCESS) { //進行錯誤處理 …… } 第 9章 高級網(wǎng)絡編程 API 2) 發(fā)送信報 當創(chuàng)建好一個 CMC對話后 ， 就可以調(diào)用 cmc_send(?)函數(shù)或 cmc_send_documents(?)函數(shù)發(fā)送信報了 。 第 9章 高級網(wǎng)絡編程 API 下面是該函數(shù)一種最簡單的調(diào)用方法： cmcStatus=(*lpfncmc_send_documents)(NULL,NULL,NULL, CMC_SEND_UI_REQUESTED?|?CMC_LOGON_UI_ ALLOWED|?CMC_ERROR_UI_ALLOWED NULL, NULL, NULL, 0)。Important Info39。c:, c:temp39。, 39。 第 9章 高級網(wǎng)絡編程 API CMC_time