通过

Extract_TP_Name (CPI-C)

  • 项目

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 个字节。