调用程序发出Set_TP_Name调用(函数名称 cmstpn),以指定合作伙伴(可调用)程序名称。 此调用将替代在发出 Initialize_Conversation 呼叫时派生自侧信息的合作伙伴计划名称。 发出 “分配 ”调用后,无法发出此调用。 发出此调用不会影响侧信息本身。
语法
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 指定 SNA 服务事务程序(TP)的名称。 但是,可以使用 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 状态。
没有状态更改。