【正文】 編程 API define CMC_E_ATTACHMENT_WRITE_FAILURE ((CMC_return_code) 5) define CMC_E_COUNTED_STRING_UNSUPPORTED ((CMC_return_code) 6) define CMC_E_DISK_FULL ((CMC_return_code) 7) define CMC_E_FAILURE ((CMC_return_code) 8) define CMC_E_INSUFFICIENT_MEMORY ((CMC_return_code) 9) define CMC_E_INVALID_CONFIGURATION ((CMC_return_code) 10) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API define CMC_E_INVALID_ENUM ((CMC_return_code) 11) define CMC_E_INVALID_FLAG ((CMC_return_code) 12) define CMC_E_INVALID_MEMORY ((CMC_return_code) 13) define CMC_E_INVALID_MESSAGE_PARAMETER ((CMC_return_code) 14) define CMC_E_INVALID_MESSAGE_REFERENCE ((CMC_return_code) 15) define CMC_E_INVALID_PARAMETER ((CMC_return_code) 16) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API define CMC_E_INVALID_SESSION_ID ((CMC_return_code) 17) define CMC_E_INVALID_UI_ID ((CMC_return_code) 18) define CMC_E_LOGON_FAILURE ((CMC_return_code) 19) define CMC_E_MESSAGE_IN_USE ((CMC_return_code) 20) define CMC_E_NOT_SUPPORTED ((CMC_return_code) 21) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API define CMC_E_PASSWORD_REQUIRED ((CMC_return_code) 22) define CMC_E_RECIPIENT_NOT_FOUND ((CMC_return_code) 23) define CMC_E_SERVICE_UNAVAILABLE ((CMC_return_code) 24) define CMC_E_TEXT_TOO_LARGE ((CMC_return_code) 25) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API define CMC_E_TOO_MANY_FILES ((CMC_return_code) 26) define CMC_E_TOO_MANY_RECIPIENTS ((CMC_return_code) 27) define CMC_E_UNABLE_TO_NOT_MARK_AS_READ ((CMC_return_code) 28) 第 9章 高級(jí)網(wǎng)絡(luò)編程 API define CMC_E_UNRECOGNIZED_MESSAGE_TYPE ((CMC_return_code) 29) define CMC_E_UNSUPPORTED_ACTION ((CMC_return_code) 30) define CMC_E_UNSUPPORTED_CHARACTER_SET ((CMC_return_code) 31) define CMC_E_UNSUPPORTED_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) 開始對(duì)話 在 CMC中執(zhí)行的所有信報(bào)操作都是在一個(gè)信報(bào)對(duì)話中進(jìn)行的 。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 )。 最后一個(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_uint32 item_data。 CMC_flags extension_flags。 第 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) 。 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 )。 該函數(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 )。 include 39。39。 …… CMC_return_code cmcStatus。 CMC_session_id cmcSession。 cmcUiAvail， //返回的值 NULL //無(wú)擴(kuò)展 )。39。39。 //下面創(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。 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。 if(cmcStatus!=CMC_SUCCESS) { //進(jìn)行錯(cuò)誤處理 …… } 第 9章 高級(jí)網(wǎng)絡(luò)編程 API 2) 發(fā)送信報(bào) 當(dāng)創(chuàng)建好一個(gè) CMC對(duì)話后 ， 就可以調(diào)用 cmc_send(?)函數(shù)或 cmc_send_documents(?)函數(shù)發(fā)送信報(bào)了 。下面是該函數(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 )。 recipient_addresses參數(shù)表示收件人地址； subject 為郵件主題； file_paths 和file_names參數(shù)指出要發(fā)送郵件的目錄和文件名；可以在同一個(gè)字符串參數(shù)中定義多個(gè)值 ， 使用 delimiter參數(shù)中定義的定界符將它們分開 。 ui_id表示發(fā)送對(duì)話框的父對(duì)話框的句柄，只有當(dāng)使用的服務(wù)提供程序具有 UI時(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)。當(dāng)不使用信報(bào)服務(wù)程序提供的 UI時(shí)，要在信報(bào)發(fā)送時(shí)設(shè)置地址等參數(shù)，例如： 第 9章 高級(jí)網(wǎng)絡(luò)編程 API cmcStatus=(*lpfncmc_send_documents)(39。to:Zhang Hong,cc:Li Ping39。, 39。Important Info39。, 39。We have a date… 39。, 0, 39。c:, c:temp39。, 39。, 39。, 39。, 39。, 0)。 第 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_string message_type。 第 9章 高級(jí)網(wǎng)絡(luò)編程 API CMC_time