【文章內(nèi)容簡介】 FromHandle(?)函數(shù)格式如下： static CSocket* PASCAL FromHandle( SOCKET hSocket )。 該函數(shù)的參數(shù)指出一個(gè)套接口句柄 ， 在調(diào)用后返回與此套接口關(guān)聯(lián)的 CSocket對象指針 。 如果沒有與此套接口關(guān)聯(lián)的對象 ，則返回 NULL。 第 9章 高級網(wǎng)絡(luò)編程 API 4． IsBlocking( )函數(shù) IsBlocking(?)函數(shù)格式如下： BOOL IsBlocking(?)。 IsBlocking(?)函數(shù)調(diào)用后返回一個(gè)布爾值 ， 作用為判斷在當(dāng)前時(shí)刻套接口是否處于阻塞狀態(tài) ， 即是否在等待某種事件的發(fā)送 。 5． CancelBlockingCall( )函數(shù) CancelBlockingCall(?)函數(shù)格式如下： void CancelBlockingCall(?)。 如果套接口處于阻塞狀態(tài) ， 那么調(diào)用CancelBlockingCall(?)函數(shù)后 ， 所有套接口的阻塞請求被刪除 。 第 9章 高級網(wǎng)絡(luò)編程 API 6． OnMessagePending( )函數(shù) OnMessagePending(?)函數(shù)格式如下： virtual BOOL OnMessagePending(?)。 該函數(shù)是一個(gè)需要重載的虛函數(shù) ， 當(dāng)套接口處于阻塞狀態(tài)時(shí) ， 調(diào)用 OnMessagePending(?)函數(shù)可以處理應(yīng)用中的其他消息 。 第 9章 高級網(wǎng)絡(luò)編程 API 信報(bào) API(MAPI) MAPI的結(jié)構(gòu) MAPI的組件如圖 91所示。 第 9章 高級網(wǎng)絡(luò)編程 API 信 報(bào) 感 知 應(yīng) 用 程 序可 傳 遞 信 報(bào) 的 應(yīng) 用 程 序基 于 信 報(bào) 的 應(yīng) 用 程 序客 戶 應(yīng) 用 程 序系 統(tǒng) 服 務(wù) 程 序M A P I圖 91 MAPI組件結(jié)構(gòu)圖 第 9章 高級網(wǎng)絡(luò)編程 API MFC對 MAPI的支持 1． 使用 VC++提供的 AppWizard 利用 AppWizard創(chuàng)建一個(gè) MAPI應(yīng)用的過程非常簡單 ， 但要注意在 MFC AppWizardStep 4 of 6對話框中要確認(rèn)對 MAPI項(xiàng)的選擇 ， 如圖 92所示 。 第 9章 高級網(wǎng)絡(luò)編程 API 圖 92 創(chuàng)建一個(gè) MAPI應(yīng)用 第 9章 高級網(wǎng)絡(luò)編程 API 如果選擇了 MAPI選項(xiàng) ， 則將為應(yīng)用程序的 File菜單增加一個(gè)傳送命令 ， 并將為 CDocument MAPI功能增加相應(yīng)的消息映射項(xiàng) 。 若在創(chuàng)建工程時(shí)沒有選擇 MAPI選項(xiàng) ， 則可以通過手工的方式增加 MAPI功能 。 以上創(chuàng)建應(yīng)用程序的過程完成后，如果執(zhí)行“文件”菜單中的“傳送 …” 命令，則彈出如圖 93所示的郵件處理窗口，用戶就可以根據(jù)郵件的具體情況輸入收件人、抄送、主題等內(nèi)容進(jìn)行郵件處理工作。但一定要注意，如果沒有設(shè)置默認(rèn)的郵件處理程序，則在運(yùn)行“傳送 …” 命令時(shí)將彈出有關(guān)郵件設(shè)置的提示信息，要求設(shè)置默認(rèn)郵件處理程序。 第 9章 高級網(wǎng)絡(luò)編程 API 圖 93 郵件處理窗口 第 9章 高級網(wǎng)絡(luò)編程 API 2． 使用 MAPI組件 如果已經(jīng)創(chuàng)建好了一個(gè)項(xiàng)目 ， 但在項(xiàng)目中并沒有使用 MAPI ， 則 可 以 使 用 VC++ 的 Project?|?Add to Project?|?Commonents and Controls菜單命令 (在中文環(huán)境下為 “ 工程 ” ｜ “ 添加工程 ” ｜ Commonents and Controls)， 彈出如圖 94所示的對話框 ， 雙擊 Visual C++ Components， 從彈出的對話框中選擇 MAPI組件即可 。然后執(zhí)行程序 ， 在 “ 文件 ” 菜單中加入 “ Send… ”菜單命令 。 第 9章 高級網(wǎng)絡(luò)編程 API 圖 94 插入 MAPI對話框 第 9章 高級網(wǎng)絡(luò)編程 API 3． 手工添加 MAPI 我們也可以通過在程序中直接加入代碼的方法添加MAPI， 操作方法如下： (1) 在 “ 文件 ” 菜單下添加 “ 傳送 … ”菜單項(xiàng) (也可以放在其他菜單下 )。 該菜單項(xiàng)的 ID可以從屬性中選擇ID_FILE_SEND_MAIL(當(dāng)然用戶也可以輸入其他 ID， 但該 ID是一個(gè)標(biāo)準(zhǔn)的 ID命令 )。 (2) 為“傳送 …” 命令增加消息映射。對于每一個(gè)CDocument類，應(yīng)該增加如下所示的消息映射項(xiàng)： 第 9章 高級網(wǎng)絡(luò)編程 API ON_COMMAND(ID_FILE_SEND_MAIL,OnFileSendMail) ON_UPDATE_COMMAND_UI(ID_FILE_SEND_MAIL,OnUpdateFileSendMail) 增加后的程序?yàn)? BEGIN_MESSAGE_MAP(CMapi1Doc, CDocument) //{{AFX_MSG_MAP(CMapi1Doc) // NOTE the ClassWizard will add and remove mapping macros here. 第 9章 高級網(wǎng)絡(luò)編程 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)絡(luò)編程 API MAPI的高級應(yīng)用 目前存在以下 4種 MAPI的客戶接口。 ● 簡單 MAPI： ● 通用信報(bào)調(diào)用 (Common Messaging Calls， CMS)： ● 擴(kuò)展 MAPI： ● ?OLE信報(bào)： 第 9章 高級網(wǎng)絡(luò)編程 API 通用信報(bào)調(diào)用 CMC 1． CMC定義的基本數(shù)據(jù)類型 CMC定義的基本數(shù)據(jù)類型有： typedef char CMC_sint8。 typedef short CMC_sint16。 typedef long int CMC_sint32。 typedef unsigned short int CMC_uint16。 typedef unsigned long int CMC_uint32。 typedef void far * CMC_buffer。 typedef char far * CMC_string。 第 9章 高級網(wǎng)絡(luò)編程 API typedef CMC_uint16 CMC_boolean。 typedef CMC_sint32 CMC_enum。 typedef CMC_uint32 CMC_return_code。 typedef CMC_uint32 CMC_flags。 typedef CMC_string CMC_object_identifier。 define CMC_FALSE ((CMC_boolean)0) define CMC_TRUE ((CMC_boolean)1) CMC中定義的其他數(shù)據(jù)類型還有： typedef CMC_uint32 CMC_session_id。 typedef CMC_uint32 CMC_ui_id。 typedef CMC_counted_string CMC_message_reference。 第 9章 高級網(wǎng)絡(luò)編程 API 2． CMC定義的標(biāo)志 在 CMC中定義了各種類型的標(biāo)志 ， 這些標(biāo)志廣泛使用在后面介紹的 CMC函數(shù)中 。 (1) ?CMC定義的擴(kuò)展標(biāo)志有： define CMC_EXT_REQUIRED ((CMC_flags) 0x00010000) define CMC_EXT_OUTPUT ((CMC_flags) 0x00020xx0) define CMC_EXT_LAST_ELEMENT ((CMC_flags) 0x80000000) 第 9章 高級網(wǎng)絡(luò)編程 API define CMC_EXT_RSV_FLAG_MASK ((CMC_flags) 0xFFFF0000) define CMC_EXT_ITEM_FLAG_MASK ((CMC_flags) 0x0000FFFF) (2) ?CMC定義的附件標(biāo)志有： define CMC_ATT_APP_OWNS_FILE ((CMC_flags) 1) define CMC_ATT_LAST_ELEMENT ((CMC_flags) 0x80000000) define CMC_ATT_OID_BINARY ? ? ? ? ? ? define CMC_ATT_OID_TEXT ? ? ? ? ? ? 第 9章 高級網(wǎng)絡(luò)編程 API (3) ?CMC定義的名稱類型標(biāo)志有： define CMC_TYPE_UNKNOWN ((CMC_enum) 0) define CMC_TYPE_INDIVIDUAL ((CMC_enum) 1) define CMC_TYPE_GROUP ((CMC_enum) 2) 第 9章 高級網(wǎng)絡(luò)編程 API (4) ?CMC定義的角色標(biāo)志有： define CMC_ROLE_TO ((CMC_enum) 0) define CMC_ROLE_CC ((CMC_enum) 1) define CMC_ROLE_BCC ((CMC_enum) 2) define CMC_ROLE_ORIGINATOR ((CMC_enum) 3) define CMC_ROLE_AUTHORIZING_USER ((CMC_enum) 4) 第 9章 高級網(wǎng)絡(luò)編程 API (5) ?CMC定義的接收標(biāo)志有： define CMC_RECIP_IGNORE ((CMC_flags) 1) define CMC_RECIP_LIST_TRUNCATED ((CMC_flags) 2) define CMC_RECIP_LAST_ELEMENT ((CMC_flags) 0x80000000) 第 9章 高級網(wǎng)絡(luò)編程 API (6) ?CMC定義的消息標(biāo)志有： define CMC_MSG_READ ((CMC_flags) 1) define CMC_MSG_TEXT_NOTE_AS_FILE ((CMC_flags) 2) define CMC_MSG_UNSENT ((CMC_flags) 4) define CMC_MSG_LAST_ELEMENT ((CMC_flags) 0x80000000) 第 9章 高級網(wǎng)絡(luò)編程 API (7) ?CMC定義的消息概要標(biāo)志有： define CMC_SUM_READ ((CMC_flags) 1) define CMC_SUM_UNSENT ((CMC_flags) 2) define CMC_SUM_LAST_ELEMENT ((CMC_flags) 0x80000000) 第 9章 高級網(wǎng)絡(luò)編程 API (8) ?CMC定義的功能標(biāo)志有： define CMC_ERROR_UI_ALLOWED ((CMC_flags) 0x01000000) defineCMC_L