调用程序发出 Set_Sync_Level 调用(函数名称 cmssl),以指定会话的同步级别。 同步级别确定程序是否通过 “确认 ”和 “确认” 调用同步其处理。
此调用将替代 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 状态。
没有状态更改。