【正文】 時 ， 可以使用默認(rèn)的 0值 ， 即由系統(tǒng)自動分配一個端口號 。 第 9章 高級網(wǎng)絡(luò)編程 API 第三個參數(shù) lEvent用來指定一個將為應(yīng)用程序生成通知的事件 。 最后一個參數(shù) lpszSocketAddress允許我們?yōu)樘捉涌谥付ㄒ粋€網(wǎng)絡(luò)地址 ， 其默認(rèn)值為 0， 表示套接口的地址將限定為本地機(jī) 。 第 9章 高級網(wǎng)絡(luò)編程 API 8． Detach( )函數(shù) Detach(?)函數(shù)格式如下： SOCKET Detach(?)。 9． FromHandle(?)函數(shù) FromHandle(?)函數(shù)格式如下： static * PASCAL FromHandle( SOCKET hSocket )。 如果沒有與此套接口關(guān)聯(lián)的 CAsyncSocket對象 ， 則返回值為空(NULL)。 在實際應(yīng)用中 ， 當(dāng)調(diào)用的操作失敗后使用該函數(shù)返回套接口的錯誤代碼 。 rPeerAddress, UINTamp。 或 BOOL GetPeerName(SOCKADDR* lpSockAddr, int* lpSockAddrLen )。 遠(yuǎn)程套接口的 IP地址和端口號分別由 rPeerAddress和rPeerPort參數(shù)返回 ， 也可以由指向 SOCKADDR結(jié)構(gòu)的參數(shù) lpSockAddr返回 。 rSocketAddress, UINTamp?；? BOOL GetSockName(SOCKADDR* lpSockAddr, int* lpSockAddrLen )。 IP地址和端口號分別由rSocketAddress 和 rSocketPort 參數(shù)返回 ， 也 可 以 由 指 向SOCKADDR結(jié)構(gòu)的參數(shù) lpSockAddr返回 。 該函數(shù)用于返回一個套接口的選項 。 該函數(shù)僅支持SOL_SOCKET和 IPPROTO_TCP兩個選項級別 。 該函數(shù)的作用與 GetSockOpt(?)函數(shù)相反 ， 用于設(shè)置一個套接口的選項 。 15． IOCtl()函數(shù) IOCtl(?)函數(shù)格式如下： BOOL IOCtl( long lCommand, DWORD* lpArgument )。 第 9章 高級網(wǎng)絡(luò)編程 API 16． Listen()函數(shù) Listen(?)函數(shù)格式如下： BOOL Listen( int nConnectionBacklog = 5 )。 參數(shù) nConnectionBacklog的取值區(qū)間為 1～ 5， 默認(rèn)值為 5，它指出正在等待連接的最大隊列長度 。 該函數(shù)是一個需要重載的回調(diào)函數(shù) ， 當(dāng)一個套接口可能需要與另一端建立連接時 ， 可以調(diào)用此函數(shù)處理相應(yīng)的消息 。 第 9章 高級網(wǎng)絡(luò)編程 API 18． OnClose( )函數(shù) OnClose(?)函數(shù)格式如下： virtual void OnClose( int nErrorCode )。 19． OnConnect()函數(shù) OnConnect(?)函數(shù)格式如下： virtual void OnConnect( int nErrorCode )。 第 9章 高級網(wǎng)絡(luò)編程 API 20． OnOutOfBandData(?)函數(shù) OnOutOfBandData(?)函數(shù)格式如下： virtual void OnOutOfBandData( int nErrorCode )。 21． OnReceive( )函數(shù) OnReceive(?)函數(shù)格式如下： virtual void OnReceive( int nErrorCode )。舉例說明如下： 第 9章 高級網(wǎng)絡(luò)編程 API // 下面的 CMyAsyncSocket是 CAsyncSocket類的派生類 void CMyAsyncSocket::OnReceive(int nErrorCode) { static int i=0。 TCHAR buff[4096]。 nRead = Receive(buff, 4096)。 break。 Close(?)。 default: buff[nRead] = 0。 m_strRecv += szTemp。 } CAsyncSocket::OnReceive(nErrorCode)。 該函數(shù)是一個需要重載的回調(diào)函數(shù) ， 當(dāng)一個套接口已經(jīng)準(zhǔn)備好數(shù)據(jù) ， 并可以由 Send(?)函數(shù)發(fā)送時 ， 就可以調(diào)用該函數(shù)處理相應(yīng)的消息 。 // int m_nBytesSent。 第 9章 高級網(wǎng)絡(luò)編程 API void CMyAsyncSocket ::OnSend(int nErrorCode) { while (m_nBytesSent m_nBytesBufferSize) { int dwBytes。 else 第 9章 高級網(wǎng)絡(luò)編程 API { TCHAR szError[256]。 Close(?)。 } } else { m_nBytesSent += dwBytes。 m_sendBuffer = 。 } 第 9章 高級網(wǎng)絡(luò)編程 API 23． Receive( )函數(shù) Receive(?)函數(shù)格式如下： virtual int Receive( void* lpBuf, int nBufLen, int nFlags = 0 )。 24． ReceiveFrom(?)函數(shù) ReceiveFrom(?)函數(shù)格式如下： 第 9章 高級網(wǎng)絡(luò)編程 API int ReceiveFrom( void* lpBuf, int nBufLen, CStringamp。 rSocketPort, int nFlags = 0 )。 該函數(shù)用于從無連接的遠(yuǎn)程套接口上讀取數(shù)據(jù)報信息 。 該函數(shù)用于向與當(dāng)前套接口已經(jīng)建立連接的遠(yuǎn)程套接口發(fā)送數(shù)據(jù) 。 或 int SendTo( const void* lpBuf, int nBufLen, const SOCKADDR* lpSockAddr, int nSockAddrLen, int nFlags = 0 )。 第 9章 高級網(wǎng)絡(luò)編程 API 27． ShutDown( )函數(shù) ShutDown(?)函數(shù)格式如下： BOOL ShutDown( int nHow = sends )。 因此 ， 可以將 ShutDown(?)的功能理解為對接收或發(fā)送功能的關(guān)閉 ， 具體的控制模式有三種 ， 如表 92所示 。它通過 MFC CArchive對象進(jìn)行信息的接收和發(fā)送操作 ， 使得套接口數(shù)據(jù)輸入和輸出如同使用 MFC的文檔一樣簡捷 、易用 。 CSocket類提供了如下的一些常用函數(shù) 。 該函數(shù)將一個套接口句柄連接到一個 CSocket對象實例上 ， 從而可以建立與另一端的連接 。 // ... class CSockThread : public CWinThread { // ... Other function and member declarations protected: CSocket m_sConnected。 第 9章 高級網(wǎng)絡(luò)編程 API SOCKET hConnected。 return TRUE。 Accept(sConnected)。 // After detaching it, it should no longer be // used in the context of this thread. // Start the other thread. AfxBeginThread(RUNTIME_CLASS(CSockThread))。 在調(diào)用 CSocket的構(gòu)造函數(shù) (該構(gòu)造函數(shù)不帶參數(shù) )創(chuàng)建了一個空的 CSocket后 ， 再調(diào)用 Create(?)函數(shù)完成具體的初始化工作 。 但對服務(wù)器套接口來說 ，通常還要為套接口指定一個端口號 。 但要注意 ， 如果我們打算使用 CArchive對象 ， 則必須使用默認(rèn)的套接口類型 SOCK_DGRAM。 地址的默認(rèn)值為 NULL， 指出套接口被創(chuàng)建時使用 INADDR_ANY。 該函數(shù)的參數(shù)指出一個套接口句柄 ， 在調(diào)用后返回與此套接口關(guān)聯(lián)的 CSocket對象指針 。 第 9章 高級網(wǎng)絡(luò)編程 API 4． IsBlocking( )函數(shù) IsBlocking(?)函數(shù)格式如下： BOOL IsBlocking(?)。 5． CancelBlockingCall( )函數(shù) CancelBlockingCall(?)函數(shù)格式如下： void CancelBlockingCall(?)。 第 9章 高級網(wǎng)絡(luò)編程 API 6． OnMessagePending( )函數(shù) OnMessagePending(?)函數(shù)格式如下： virtual BOOL OnMessagePending(?)。 第 9章 高級網(wǎng)絡(luò)編程 API 信報 API(MAPI) MAPI的結(jié)構(gòu) MAPI的組件如圖 91所示。 第 9章 高級網(wǎng)絡(luò)編程 API 圖 92 創(chuàng)建一個 MAPI應(yīng)用 第 9章 高級網(wǎng)絡(luò)編程 API 如果選擇了 MAPI選項 ， 則將為應(yīng)用程序的 File菜單增加一個傳送命令 ， 并將為 CDocument MAPI功能增加相應(yīng)的消息映射項 。 以上創(chuàng)建應(yīng)用程序的過程完成后，如果執(zhí)行“文件”菜單中的“傳送 …” 命令，則彈出如圖 93所示的郵件處理窗口，用戶就可以根據(jù)郵件的具體情況輸入收件人、抄送、主題等內(nèi)容進(jìn)行郵件處理工作。 第 9章 高級網(wǎng)絡(luò)編程 API 圖 93 郵件處理窗口 第 9章 高級網(wǎng)絡(luò)編程 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組件即可 。 第 9章 高級網(wǎng)絡(luò)編程 API 圖 94 插入 MAPI對話框 第 9章 高級網(wǎng)絡(luò)編程 API 3． 手工添加 MAPI 我們也可以通過在程序中直接加入代碼的方法添加MAPI， 操作方法如下： (1) 在 “ 文件 ” 菜單下添加 “ 傳送 … ”菜單項 (也可以放在其他菜單下 )。 (2) 為“傳送 …” 命令增加消息映射。 ● 簡單 MAPI： ● 通用信報調(diào)用 (Common Messaging Calls， CMS)： ● 擴(kuò)展 MAPI： ● ?OLE信報： 第 9章 高級網(wǎng)絡(luò)編程 API 通用信報調(diào)用 CMC 1． CMC定義的基本數(shù)據(jù)類型 CMC定義的基本數(shù)據(jù)類型有： typedef char CMC_sint8。 typedef long int CMC_sint32。 typedef unsigned long int CMC_uint32。 typedef char far * CMC_string。 typedef CMC_sint32 CMC_enum。 typedef CMC_uint32 CMC_flags。 define CMC_FALSE ((CMC_boolean)0) define CMC_TRUE ((CMC_boolean)1) CMC中定義的其他數(shù)據(jù)類型還有： typedef CMC_uint32 CMC_session_id。 typedef CMC_counted_string CMC_message_reference。 (1) ?CMC定義的擴(kuò)展標(biāo)志有： define CMC_EXT_REQUIRED ((CMC_flags) 0x00010000) define CM