通过

Set_Partner_LU_Name（CPI-C）

调用 程序发出Set_Partner_LU_Name 调用（函数名称 cmsー）以指定合作伙伴逻辑单元（LU）名称。 此调用覆盖发出 Initialize_Conversation 呼叫时派生自侧信息的合作伙伴 LU 名称。 发出 “分配 ”后，无法发出此调用。 发出此调用不会影响侧信息本身。

语法

  
CM_ENTRY Set_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_name_length,    
  CM_INT32 FAR *return_code              
);

参数

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

partner_LU_name
提供的参数。 指定合作伙伴 LU 名称的起始地址。 模式名称最多可以包含 17 个 ASCII 字符。 允许的字符为：

  • 大写字母。

  • 数字从 0 到 9。

    合作伙伴 LU 名称可以是：

  • 由一到八个字符组成的别名。

  • 由 2 到 17 个字符组成的完全限定网络名称。 句点将网络标识符（可以是 0 到 8 个字符）与网络 LU 名称（可以是 1 到 8 个字符）分开。 如果网络标识符长度为零，则仍需要句点。

    合作伙伴 LU 名称必须与在配置过程中建立的合作伙伴 LU 的名称匹配。

    partner_LU_name_length
    提供的参数。 指定伙伴 LU 名称的长度。 范围从 1 到 17。

    return_code
    从此调用返回的代码。 本主题后面列出了有效的返回代码。

返回代码

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

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

CM_PROGRAM_PARAMETER_CHECK
主要返回代码;发生以下事件之一：

  • 由conversation_ID指定的值无效。

  • 由partner_LU_name_length指定的值超出范围（大于 17 或小于 1）。

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

状态更改

会话必须处于 INITIALIZE 状态。

没有状态更改。

注解

在发出“分配”之前，不会为partner_LU_name指定无效值。