通过

Convert_Incoming (CPI-C)

  • 项目

Convert_Incoming调用 (函数名称 cmcnvi) 将 EBCDIC 字符字符串转换为 ASCII。 请注意，可以使用 Convert_Outgoing 执行返回转换。

语法

  
CM_ENTRY Convert_Incoming(   
  unsigned char FAR *string,    
  CM_INT32 FAR *string_length,  
  CM_INT32 FAR *return_code   
);

参数

string
提供的参数。 指定要转换的 EBCDIC 字符串。 该字符串可以包含以下任意字符：

  • 大写 A–Z

  • 小写 a–z

  • 数字 0-9

  • 命令

  • 空格字符

  • 特殊字符 <> + - ( ) & * ; ： ， ' ？ / _= ".

    此字符串的string_length 字符将替换为 ASCII 等效项。

    string_length
    提供的参数。 指定要 (1-32767) 转换的字符数。

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

返回代码

CM_OK
主返回代码;调用已成功执行， 字符串 参数现在包含转换后的 ASCII 字符串。

CM_OPERATION_NOT_ACCEPTED
主返回代码; string_length 参数指定的值无效。

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

状态更改

会话可以处于任何状态。

没有状态更改。

注解

在基本会话中以缓冲区格式接收数据时，数据缓冲区可能包含多个逻辑记录，每个记录由 2 字节长度字段组成， (NN) 后跟数据。 应用程序必须单独提取和转换每个数据字符串， (不包括长度字段值) 。 应用程序不得尝试在一次操作中转换整个缓冲区，因为这会使长度字段值无效。