Set_Sync_Level呼叫 (函式名稱 cmssl) 是由叫用程式發出,以指定交談的同步處理層級。 同步處理層級會決定程式是否透過 Confirm 和 Confirmed 呼叫同步處理其處理。
此呼叫會覆寫 Initialize_Conversation 呼叫所建立的同步處理層級。 默認同步處理層級是CM_NONE,表示沒有同步處理。 發出 [配置 ] 呼叫之後,便無法發出此呼叫。
語法
CM_ENTRY Set_Sync_Level(
unsigned char FAR *conversation_ID,
CM_INT32 FAR *sync_level,
CM_INT32 FAR *return_code
);
參數
conversation_ID
提供的參數。 指定交談的標識碼。 此參數的值是由 Initialize_Conversation 所傳回。
sync_level
提供的參數。 指定交談的同步處理層級。 可能的值為:
CM_NONE
程式不會執行確認處理。
CM_CONFIRM
程式可以執行確認處理。
return_code
從這個呼叫傳回的程序代碼。 本主題稍後會列出有效的傳回碼。
回傳代碼
CM_OK
主要傳回碼;已成功執行的呼叫。
CM_PROGRAM_STATE_CHECK
主要傳回碼;交談不是處於 INITIALIZE 狀態。
CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項:
conversation_ID或sync_level指定的值無效。
sync_level參數會指定CM_NONE,但發生下列其中一項:send_type參數設定為 CM_SEND_AND_CONFIRM、prepare_to_receive_type 參數設定為 CM_PREP_TO_RECEIVE_CONFIRM,或deallocate_type設定為 CM_DEALLOCATE_CONFIRM。
CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤,且已在產品錯誤記錄檔中記錄。
狀態變更
交談必須處於 INITIALIZE 狀態。
沒有狀態變更。