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

　　

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