通过

Convert_Outgoing (CPI-C)

  • 项目

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

语法

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

参数

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

  • 大写 A–Z

  • 小写 a–z

  • 数字 0–9

  • 命令

  • 空格字符

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

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

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

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

返回代码

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

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

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

状态更改

会话可以处于任何状态。

没有状态更改。

注解

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