通过

Set_TP_Name (CPI-C)

  • 项目

调用程序发出Set_TP_Name调用 (函数名称 cmstpn) ，以指定合作伙伴 (可调用) 程序名称。 发出 Initialize_Conversation 调用时，此调用将替代从侧信息派生的合作伙伴计划名称。 发出 Allocate 调用后，无法发出此调用。 发出此调用对端信息本身没有影响。

语法

  
CM_ENTRY Set_TP_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *TP_name,            
    CM_INT32 FAR *TP_name_length,          
  CM_INT32 FAR *return_code              
);

参数

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

TP_name
提供的参数。 指定合作伙伴计划名称的起始地址。 程序名称最多可以包含 64 个 ASCII 字符。 允许的字符包括：

  • 大写和小写字母。

  • 数字从 0 到 9。

  • 特殊字符，空格除外。

    不能使用 Set_TP_Name (TP) 指定 SNA 服务事务程序的名称。 但是，可以使用 Set_CPIC_Side_Information 执行此操作。

    不支持双字节字符集，如汉字。

    TP_name_length
    提供的参数。 指定合作伙伴计划名称的长度。 范围为 1 到 64。

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

返回代码

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

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

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

  • conversation_ID 指定的值无效。

  • TP_name_length指定的值超出范围 (大于 64 或小于 1) 。

  • 变量的地址无效。

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

状态更改

会话必须处于 INITIALIZE 状态。

没有状态更改。