通过

Set_Mode_Name (CPI-C)

  • 项目

Set_Mode_Name调用 (函数名称 cmsmn) 由调用程序发出，以指定会话的模式名称。 发出 Initialize_Conversation 调用时，此调用将替代派生自端信息的系统定义模式名称。 发出分配后，无法发出此调用。 发出此调用对端信息本身没有影响。

语法

  
CM_ENTRY Set_Mode_Name(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *mode_name,      
  CM_INT32 FAR *mode_name_length,    
  CM_INT32 FAR *return_code          
);

参数

conversation_ID
提供的参数。 指定会话的标识符。 此参数的值由 Initialize_Conversation 返回。

mode_name
提供的参数。 指定模式名称的起始地址 (配置) 期间定义的一组网络特征的名称。 模式名称最多可以包含 8 个 ASCII 字符。 允许的字符为：

  • 大写字母。

  • 数字从 0 到 9。

    mode_name 的值必须与配置期间 LU) (伙伴逻辑单元关联的模式的名称匹配。 模式名称不能是 SNASVCMG 或 CPSVCMG。

    mode_name_length
    提供的参数。 指定模式名称的长度。 范围为 0 到 8 个字节。

    如果 mode_name_length 设置为零， 则忽略Set_Mode_Name 。

    return_code
    此调用返回的代码。 本主题稍后将列出有效的返回代码。

返回代码

CM_OK
主返回代码;已成功执行的调用。

CM_PROGRAM_STATE_CHECK
主返回代码;会话未处于 INITIALIZE 状态。

CM_PROGRAM_PARAMETER_CHECK
主返回代码;发生了以下情况之一：

  • conversation_ID指定的值无效。

  • mode_name_length 指定的值超出范围 (大于 8 或小于 0) 。

    CM_PRODUCT_SPECIFIC_ERROR
    主返回代码;发生特定于产品的错误，并且已记录在产品错误日志中。

状态更改

会话必须处于 INITIALIZE 状态。

没有状态更改。

注解

在发出“分配”之前，不会检测到为mode_name指定无效值。