通过

Specify_Local_TP_Name (CPI-C)

  • 项目

( 函数名称 cmsltp) 发出Specify_Local_TP_Name调用，以指示程序能够接受定向到给定名称的传入对话。

语法

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

参数

TP_name
提供的参数。 指定本地事务程序的起始地址 (TP) 名称。 程序名称最多可以包含 64 个 ASCII 字符。 允许的字符为：

  • 大写字母和小写字母。

  • 数字从 0 到 9。

  • 特殊字符，空格除外。

    不能使用 Specify_Local_TP_Name 指定 SNA 服务 TP 的名称。

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

    TP_name_length
    提供的参数。 指定本地程序名称的长度。 范围为 1 到 64。

    return_code
    此调用返回的代码。 本主题稍后将列出有效的返回代码。

返回代码

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

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

  • 提供的 TP_name 无效。

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

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

状态更改

该调用不与特定会话关联，并且没有状态限制适用。

没有状态更改。

注解

程序可以多次发出此调用，以处理具有多个 TP 名称的传入对话。 程序可以通过调用 Extract_TP_Name来发现传入对话上的实际名称。