Extract_TP_Name调用(函数名称 cmetpn)返回TP_name特征。
语法
CM_ENTRY Extract_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 或 Accept_Conversation返回。
TP_name
返回的参数。 指定包含事务程序 (TP) 名称的变量。
TP_name_length
返回的参数。 指定 TP 名称的长度。
return_code
从此调用返回的代码。 本主题后面列出了有效的返回代码。
返回代码
CM_OK
主要返回代码;调用已成功执行。
CM_PROGRAM_PARAMETER_CHECK
主要返回代码; 由conversation_ID 指定的值无效。
CM_PRODUCT_SPECIFIC_ERROR
主要返回代码;发生了特定于产品的错误,并且已记录在产品错误日志中。
状态更改
对话可以处于除 RESET 之外的任何状态。
没有状态更改。
注解
对于调用程序,TP_name特征是Initialize_Conversation调用sym_dest_name参数中引用的侧信息中的值。 对于可调用的程序,它是会话启动请求中指定的名称(该名称将与本地或 Specify_Local_TP_Name 调用中指定的名称匹配),因此与合作伙伴计划的 TP_name 特征相同。
返回的名称长度可达 64 字节。