通过

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_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 状态。

没有状态更改。