调用 程序发出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指定无效值。