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
主要傳回碼;發生產品特定的錯誤,並已記錄在 products 錯誤記錄檔中。

狀態變更

交談可以處於任何狀態。

沒有狀態變更。

備註

在基本對話中以緩衝區格式接收資料時,資料緩衝區可能包含多個邏輯記錄,每個都包含兩個位元組的長度欄位 (NN) 後面接著資料。 應用程式必須將每個資料字串分開解壓縮和轉換 (不包括長度域值) 。 應用程式不能在一項作業中嘗試轉換整個緩衝區,因為這樣會讓長度域值無效。