【導(dǎo)讀】API函數(shù)，它提供了與較低層WindowsSockets對(duì)話(huà)的接口，底層的網(wǎng)絡(luò)事件通知及信息回叫控制等操作。下面只進(jìn)行一些簡(jiǎn)單的說(shuō)明。戶(hù)套接口地址長(zhǎng)度的指針。該函數(shù)用于在套接口準(zhǔn)備好之后請(qǐng)求事件通知。事件的含義見(jiàn)表8-5，其對(duì)應(yīng)的數(shù)值如表9-1所示。就可以實(shí)現(xiàn)與另一臺(tái)計(jì)算機(jī)的連接了。它有兩種調(diào)用格式：第一種調(diào)用格式提。SOCKADDR結(jié)構(gòu)類(lèi)型的地址參數(shù)。由CAsyncSocket的析構(gòu)函數(shù)自動(dòng)調(diào)用的。象后，需要調(diào)用Create(?)函數(shù)中，第一個(gè)參數(shù)nSocketPort用于指定一。是告訴系統(tǒng)可以由系統(tǒng)給該套接口分配一個(gè)端口號(hào)。用該端口號(hào)與服務(wù)器連接。在開(kāi)發(fā)客戶(hù)程序時(shí)，可以使用。還是數(shù)據(jù)報(bào)式套接口。在默認(rèn)情況下，所有的事件都會(huì)生成通知。該地址以點(diǎn)分十進(jìn)制的形式給定，如。該函數(shù)的作用是將上一次建立關(guān)聯(lián)的套接口句柄斷開(kāi)，是返回與此套接口關(guān)聯(lián)的CAsyncSocket對(duì)象的指針。

　　

【正文】 NSUPPORTED_DATA_EXT ((CMC_return_code) 32) define CMC_E_UNSUPPORTED_FLAG ((CMC_return_code) 33) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API defineCMC_E_UNSUPPORTED_FUNCTION_EXT ((CMC_return_code) 34) defineCMC_E_UNSUPPORTED_VERSION ((CMC_return_code) 35) defineCMC_E_USER_CANCEL ((CMC_return_code) 36) defineCMC_E_USER_NOT_LOGGED_ON ((CMC_return_code) 37) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 3． CMC處理信報(bào)的過(guò)程 1) 開(kāi)始對(duì)話(huà) 在 CMC中執(zhí)行的所有信報(bào)操作都是在一個(gè)信報(bào)對(duì)話(huà)中進(jìn)行的 。 調(diào)用 cmc_logon(?)函數(shù)可以創(chuàng)建一個(gè) CMC對(duì)話(huà) ， cmc_logon(?)函數(shù)將利用信報(bào)服務(wù)程序建立與郵件服務(wù)器的連接 ， 檢查用戶(hù)的登錄號(hào) (即標(biāo)識(shí)用戶(hù) )， 設(shè)置郵件服務(wù)器的屬性參數(shù) ， 并返回一個(gè)對(duì)話(huà)句柄 。cmc_logon(?)函數(shù)的調(diào)用格式如下： 第 9章 高級(jí)網(wǎng)絡(luò)編程 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章 高級(jí)網(wǎng)絡(luò)編程 API 該函數(shù)的參數(shù)很簡(jiǎn)單 ， 從各參數(shù)的名稱(chēng)就可以看出其含義 。 最后一個(gè)參數(shù) logon_extensions 是一個(gè)指向CMC_extension結(jié)構(gòu)數(shù)組的指針 ， 該結(jié)構(gòu)在下面的很多函數(shù)中都要用到 ， 它包含了使用 CMC API函數(shù)或結(jié)構(gòu)時(shí)的擴(kuò)展數(shù)據(jù) 。 CMC_extension結(jié)構(gòu)的定義如下： typedef struct { CMC_uint32 item_code。 CMC_uint32 item_data。 CMC_buffer item_reference。 CMC_flags extension_flags。 } CMC_extension。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 該結(jié)構(gòu)的最后一個(gè)字段 extension_flags使用時(shí)要注意 ， 它設(shè)置為 CMC_EXT_LAST_ELEMENT時(shí) ， 表示是結(jié)構(gòu)數(shù)據(jù)中的最后一個(gè)結(jié)構(gòu) 。 用戶(hù)可以通過(guò)使用 cmc_query_configuration(?)函數(shù)來(lái)獲取CMC當(dāng)前的安裝信息 ， 包括缺省的用戶(hù) 、 信報(bào)服務(wù)和用戶(hù)入網(wǎng)條件及其他的一些信息 。 cmc_query_configuration(?)函數(shù)的調(diào)用格式如下： CMC_return_code cmc_query_configuration( CMC_session_id session, CMC_enum item, CMC_buffer reference, CMC_extension FAR *config_extensions )。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 當(dāng)要結(jié)束一個(gè)對(duì)話(huà)時(shí) ， 應(yīng)該調(diào)用 cmc_logoff(?)函數(shù)來(lái)關(guān)閉一個(gè)對(duì)話(huà) 。 該函數(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 )。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 開(kāi)始對(duì)話(huà)的過(guò)程就是初始化 CMC的過(guò)程 ， 下面我們舉一個(gè)實(shí)例來(lái)說(shuō)明對(duì)話(huà)過(guò)程的開(kāi)始和結(jié)束 。 include 39。39。39。39。 …… CMC_return_code cmcStatus。 CMC_Boolean cmcUiAvail。 CMC_session_id cmcSession。 //查詢(xún)?cè)搶?shí)現(xiàn)中 UI(user interface)的可用性 第 9章 高級(jí)網(wǎng)絡(luò)編程 API cmcStatus=cmc_query_configuration( 0， //沒(méi)有會(huì)話(huà)句柄 CMC_CONFIG_UI_AVAIL， //該參數(shù)用來(lái)查詢(xún) UI的可用性 (void*)amp。 cmcUiAvail， //返回的值 NULL //無(wú)擴(kuò)展 )。 if(cmcStatus!=CMC_SUCCESS) { //進(jìn)行錯(cuò)誤處理 …… } 第 9章 高級(jí)網(wǎng)絡(luò)編程 API else if(cmcUiAvail) printf(39。39。Logon UI is available39。39。)。 //下面創(chuàng)建一個(gè)會(huì)話(huà) cmcStatus=cmc_logon( NULL, //使用默認(rèn)服務(wù) NULL, //用戶(hù)名 NULL, //用戶(hù)口令 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。cmcSession, //返回對(duì)話(huà) NULL //無(wú)擴(kuò)展 )。 if(cmcStatus!=CMC_SUCCESS) { //進(jìn)行錯(cuò)誤處理 …… } 第 9章 高級(jí)網(wǎng)絡(luò)編程 API CMC_VERSION, //Version 1 CMC CMC_LOGON_UI_ALLOWED | CMC_ERROR_UI_ALLOWED amp。cmcSession, //返回對(duì)話(huà) NULL //無(wú)擴(kuò)展 )。 if(cmcStatus!=CMC_SUCCESS) { //進(jìn)行錯(cuò)誤處理 …… } 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 2) 發(fā)送信報(bào) 當(dāng)創(chuàng)建好一個(gè) CMC對(duì)話(huà)后 ， 就可以調(diào)用 cmc_send(?)函數(shù)或 cmc_send_documents(?)函數(shù)發(fā)送信報(bào)了 。 CMC API提供的 cmc_send_documents(?)函數(shù)功能強(qiáng)大 ,?幾乎包括了發(fā)送信報(bào)時(shí)所需的所有功能，如它可以創(chuàng)建一個(gè)對(duì)話(huà)，而不必使用 cmc_logon(?)函數(shù)。下面是該函數(shù)的原型： 第 9章 高級(jí)網(wǎng)絡(luò)編程 API CMC_return_code cmc_send_documents( CMC_string recipient_addresses, CMC_string subject, CMC_string text_note, CMC_flags send_doc_flags, CMC_string file_paths, CMC_string file_names, CMC_string delimiter, CMC_ui_id ui_id )。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 該函數(shù)的大多數(shù)參數(shù)是字符串型的 。 recipient_addresses參數(shù)表示收件人地址； subject 為郵件主題； file_paths 和file_names參數(shù)指出要發(fā)送郵件的目錄和文件名；可以在同一個(gè)字符串參數(shù)中定義多個(gè)值 ， 使用 delimiter參數(shù)中定義的定界符將它們分開(kāi) 。 接收者的地址可以是確定的地址，例如，也可以是地址手冊(cè)、其他程序中接收者的名字。 ui_id表示發(fā)送對(duì)話(huà)框的父對(duì)話(huà)框的句柄，只有當(dāng)使用的服務(wù)提供程序具有 UI時(shí)才可以使用。要使用信報(bào)服務(wù)提供的對(duì)話(huà)框，必須把 send_doc_flags參數(shù)的值設(shè)置為CMC_SEND_UI_REQUESTED，這樣才允許用戶(hù)利用普通目的新信報(bào)對(duì)話(huà)框來(lái)選擇地址，并進(jìn)入信報(bào)的文本和附屬文件中，此時(shí)為消息確定的任何參數(shù)將出現(xiàn)在對(duì)話(huà)框中成為默認(rèn)值，這些參數(shù)也可以為空。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 下面是該函數(shù)一種最簡(jiǎn)單的調(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)。 該調(diào)用中的標(biāo)志 CMC_LOGON_UI_ALLOWED和CMC_ERROR_UI_ALLOWED表示允許信報(bào)服務(wù)程序利用本身的 UI進(jìn)行登錄和錯(cuò)誤處理等工作。當(dāng)不使用信報(bào)服務(wù)程序提供的 UI時(shí)，要在信報(bào)發(fā)送時(shí)設(shè)置地址等參數(shù)，例如： 第 9章 高級(jí)網(wǎng)絡(luò)編程 API cmcStatus=(*lpfncmc_send_documents)(39。39。to:Zhang Hong,cc:Li Ping39。39。, 39。39。Important Info39。39。, 39。39。We have a date… 39。39。, 0, 39。39。c:, c:temp39。39。, 39。39。, 39。39。, 39。39。, 39。39。, 0)。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API cmc_send(?)函數(shù)可以提供更強(qiáng)的發(fā)送信報(bào)控制功能 ， 它的調(diào)用格式如下： CMC_return_code cmc_send( CMC_session_id session, CMC_message FAR *message, CMC_flags send_flags, CMC_ui_id ui_id, CMC_extension FAR *send_extensions )。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 該函數(shù)使用了一個(gè) CMC_message結(jié)構(gòu) ， 以確定要發(fā)送的信報(bào)和有關(guān)信報(bào)的信息 ， 這些信息包括接收者 、信報(bào)內(nèi)容 、 附件等 。 CMC_message結(jié)構(gòu)的定義如下： typedef struct { CMC_message_reference FAR *message_reference。 CMC_string message_type。 CMC_string subject。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API CMC_time