【正文】 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 該函數(shù)使用了一個(gè) CMC_message結(jié)構(gòu) ， 以確定要發(fā)送的信報(bào)和有關(guān)信報(bào)的信息 ， 這些信息包括接收者 、信報(bào)內(nèi)容 、 附件等 。, 39。We have a date… 39。to:Zhang Hong,cc:Li Ping39。 recipient_addresses參數(shù)表示收件人地址； subject 為郵件主題； file_paths 和file_names參數(shù)指出要發(fā)送郵件的目錄和文件名；可以在同一個(gè)字符串參數(shù)中定義多個(gè)值 ， 使用 delimiter參數(shù)中定義的定界符將它們分開(kāi) 。 //下面創(chuàng)建一個(gè)會(huì)話 cmcStatus=cmc_logon( NULL, //使用默認(rèn)服務(wù) NULL, //用戶名 NULL, //用戶口令 NULL, //使用默認(rèn)字符集 0, //使用默認(rèn) UI標(biāo)識(shí) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API CMC_VERSION, //Version 1 CMC CMC_LOGON_UI_ALLOWED | CMC_ERROR_UI_ALLOWED amp。 CMC_session_id cmcSession。 該函數(shù)的調(diào)用格式如下： CMC_return_code cmc_logoff( CMC_session_id session, CMC_ui_id ui_id, CMC_flags logoff_flags, CMC_extension FAR *logoff_extensions )。 CMC_uint32 item_data。 typedef CMC_counted_string CMC_message_reference。 typedef char far * CMC_string。 (2) 為“傳送 …” 命令增加消息映射。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 圖 92 創(chuàng)建一個(gè) MAPI應(yīng)用 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 如果選擇了 MAPI選項(xiàng) ， 則將為應(yīng)用程序的 File菜單增加一個(gè)傳送命令 ， 并將為 CDocument MAPI功能增加相應(yīng)的消息映射項(xiàng) 。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 4． IsBlocking( )函數(shù) IsBlocking(?)函數(shù)格式如下： BOOL IsBlocking(?)。 但對(duì)服務(wù)器套接口來(lái)說(shuō) ，通常還要為套接口指定一個(gè)端口號(hào) 。 return TRUE。 CSocket類提供了如下的一些常用函數(shù) 。 或 int SendTo( const void* lpBuf, int nBufLen, const SOCKADDR* lpSockAddr, int nSockAddrLen, int nFlags = 0 )。 24． ReceiveFrom(?)函數(shù) ReceiveFrom(?)函數(shù)格式如下： 第 9章 高級(jí)網(wǎng)絡(luò)編程 API int ReceiveFrom( void* lpBuf, int nBufLen, CStringamp。 Close(?)。 該函數(shù)是一個(gè)需要重載的回調(diào)函數(shù) ， 當(dāng)一個(gè)套接口已經(jīng)準(zhǔn)備好數(shù)據(jù) ， 并可以由 Send(?)函數(shù)發(fā)送時(shí) ， 就可以調(diào)用該函數(shù)處理相應(yīng)的消息 。 Close(?)。舉例說(shuō)明如下： 第 9章 高級(jí)網(wǎng)絡(luò)編程 API // 下面的 CMyAsyncSocket是 CAsyncSocket類的派生類 void CMyAsyncSocket::OnReceive(int nErrorCode) { static int i=0。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 18． OnClose( )函數(shù) OnClose(?)函數(shù)格式如下： virtual void OnClose( int nErrorCode )。 15． IOCtl()函數(shù) IOCtl(?)函數(shù)格式如下： BOOL IOCtl( long lCommand, DWORD* lpArgument )。 IP地址和端口號(hào)分別由rSocketAddress 和 rSocketPort 參數(shù)返回 ， 也 可 以 由 指 向SOCKADDR結(jié)構(gòu)的參數(shù) lpSockAddr返回 。 或 BOOL GetPeerName(SOCKADDR* lpSockAddr, int* lpSockAddrLen )。 9． FromHandle(?)函數(shù) FromHandle(?)函數(shù)格式如下： static * PASCAL FromHandle( SOCKET hSocket )。 在開(kāi)發(fā)客戶程序時(shí) ， 可以使用默認(rèn)的 0值 ， 即由系統(tǒng)自動(dòng)分配一個(gè)端口號(hào) 。 或 BOOL Connect( const SOCKADDR* lpSockAddr, int nSockAddrLen )。 或 BOOL Bind ( const SOCKADDR* lpSockAddr, int nSockAddrLen )。rConnectedSocket參數(shù)為監(jiān)聽(tīng)套接口； lpSockAddr參數(shù)為指向地址的指針 ， 其初始值為空 ， 在連接建立后保存遠(yuǎn)程套接口的 IP地址； lpSockAddrLen參數(shù)為指向客戶套接口地址長(zhǎng)度的指針 。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 1． Accept(?)函數(shù) Accept(?)函數(shù)格式如下： virtual BOOL Accept(CAsyncSocketamp。 該函數(shù)的作用是將一個(gè)套接口句柄連接到一個(gè)CAsyncSocket對(duì)象實(shí)例上 ， 即建立兩者的關(guān)聯(lián) ， 這樣就可以實(shí)現(xiàn)與另一臺(tái)計(jì)算機(jī)的連接了 。 要注意的是 ， Close(?)函數(shù)是在對(duì)象被刪除時(shí)由 CAsyncSocket的析構(gòu)函數(shù)自動(dòng)調(diào)用的 。 因?yàn)镃AsyncSocket的構(gòu)造函數(shù)沒(méi)有帶參數(shù) ， 所以它只創(chuàng)建一個(gè)新的空套接口對(duì)象 ， 創(chuàng)建底層套接口的真正工作是由Create(?)函數(shù)來(lái)完成的 。 該地址以點(diǎn)分十進(jìn)制的形式給定 ， 如“ ”。 11． GetPeerName( )函數(shù) GetPeerName(?)函數(shù)格式如下： BOOL GetPeerName(CStringamp。 rSocketPort )。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 14． SetSockOpt( )函數(shù) SetSockOpt(?)函數(shù)格式如下： BOOL SetSockOpt( int nOptionName, const void* lpOptionValue, ?? int nOptionLen, int nLevel = SOL_SOCKET )。 17． OnAccept( )函數(shù) OnAccept(?)函數(shù)格式如下： virtual void OnAccept( int nErrorCode )。 該函數(shù)是一個(gè)需要重載的回調(diào)函數(shù) ， 如果一些非常急需的數(shù)據(jù)已經(jīng)準(zhǔn)備好 ， 就會(huì)發(fā)出相應(yīng)的消息 ， 這一類消息的處理需要由該函數(shù)完成 。 switch (nRead) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API { case 0: Close(?)。 // m_strRecv 是一 個(gè)在CMyAsyncSocket中說(shuō)明的字符串 if ((bye) == 0 ) ShutDown(?)。 if ((dwBytes = Send((LPCTSTR)m_sendBuffer + m_nBytesSent, m_nBytesBufferSize m_nBytesSent)) == SOCKET_ERROR) { if (GetLastError(?) == WSAEWOULDBLOCK) break。 } CAsyncSocket::OnSend(nErrorCode)。 25． Send( )函數(shù) Send(?)函數(shù)格式如下： virtual int Send( const void* lpBuf, int nBufLen, int nFlags = 0 )。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 表 92 控制模式的值 關(guān)閉方式 值 含 義 R e c e i v e s 0 關(guān)閉接收功能 S e n d s 1 關(guān)閉發(fā)送功能 B o t h 2 同時(shí)關(guān)閉接收功能和發(fā)送功能 第 9章 高級(jí)網(wǎng)絡(luò)編程 API CSocket類 CSocket類派生于 CAsyncSocket類 ， 它繼承了父類中一些常用 、 易懂的 Windows Sockets API 函數(shù) ， 并對(duì)CAsyncSocket底層中較難控制的一些 API函數(shù)或成員函數(shù)進(jìn)行了處理 ， 為 Winsock API提供了一個(gè)更高級(jí)別的編程接口 。 }。 } 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 2． Create( )函數(shù) Create(?)函數(shù)格式如下： BOOL Create( UINT nSocketPort = 0, int nSocketType = SOCK_STREAM, ? LPCTSTR lpszSocketAddress = NULL )。 3． FromHandle( )函數(shù) FromHandle(?)函數(shù)格式如下： static CSocket* PASCAL FromHandle( SOCKET hSocket )。 該函數(shù)是一個(gè)需要重載的虛函數(shù) ， 當(dāng)套接口處于阻塞狀態(tài)時(shí) ， 調(diào)用 OnMessagePending(?)函數(shù)可以處理應(yīng)用中的其他消息 。然后執(zhí)行程序 ， 在 “ 文件 ” 菜單中加入 “ Send… ”菜單命令 。 typedef unsigned short int CMC_uint16。 typedef CMC_string CMC_object_identifier。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 該函數(shù)的參數(shù)很簡(jiǎn)單 ， 從各參數(shù)的名稱就可以看出其含義 。 用戶可以通過(guò)使用 cmc_query_configuration(?)函數(shù)來(lái)獲取CMC當(dāng)前的安裝信息 ， 包括缺省的用戶 、 信報(bào)服務(wù)和用戶入網(wǎng)條件及其他的一些信息 。39。Logon UI is available39。 CMC API提供的 cmc_send_documents(?)函數(shù)功能強(qiáng)大 ,?幾乎包括了發(fā)送信報(bào)時(shí)所需的所有功能，如它可以創(chuàng)建一個(gè)對(duì)話，而不必使用 cmc_logon(?)函數(shù)。 該調(diào)用中的標(biāo)志 CMC_LOGON_UI_ALLOWED和CMC_ERROR_UI_ALLOWED表示允許信報(bào)服務(wù)程序利用本身的 UI進(jìn)行登錄和錯(cuò)誤處理等工作。39。39。39。 CMC_string subject。39。39。39。要使用信報(bào)服務(wù)提供的對(duì)話框，必須把 send_doc_flags參數(shù)的值設(shè)置為CMC_SEND_UI_REQUESTED，這樣才允許用戶利用普通目的新信報(bào)對(duì)話框來(lái)選擇地址，并進(jìn)入信報(bào)的文本和附屬文件中，此時(shí)為消息確定的任何參數(shù)將出現(xiàn)在對(duì)話框中成為默認(rèn)值，這些參數(shù)也可以為空。cmcSession, //返回對(duì)話 NULL //無(wú)擴(kuò)展 )。 if(cmcStatus!=CMC_SUCCESS) { //進(jìn)行錯(cuò)誤處理 …… } 第 9章 高級(jí)網(wǎng)絡(luò)編程 API else if(cmcUiAvail) printf(39。39。 } CMC_extension。 調(diào)用 cmc_logon(?)函數(shù)可以創(chuàng)建一個(gè) CMC對(duì)話 ， cmc_logon(?)函數(shù)將利用信報(bào)服務(wù)程序建立與郵件服務(wù)器的連接 ， 檢查用戶的登錄號(hào) (即標(biāo)識(shí)用戶 )， 設(shè)置郵件服務(wù)器的屬性參數(shù) ， 并返回一個(gè)對(duì)話句柄 。 typedef CMC_uint32 CMC_return_code。 typedef short CMC_sint16。但一定要注意，如果沒(méi)有設(shè)置默認(rèn)的郵件處理程序，則在運(yùn)行“傳送 …” 命令時(shí)將彈出有關(guān)郵件設(shè)置的提示