Set_Sync_Level(CPI-C)

调用程序发出 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_IDsync_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 状态。

没有状态更改。