共用方式為


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   
);  

參數

字串
提供的參數。 指定要轉換的 ASCII 字串。 字串可能包含下列任何字元:

  • 大寫 A–Z

  • 小寫英文字母 a–z

  • 數位 0–9

  • 期間 (.)

  • 空格字元

  • 特殊字元 <> + - ( ) + * ; : , ' ? / _= ".

    此字串的string_length 字元將會由EBCDIC對等專案取代。

    string_length
    提供的參數。 指定要轉換的字元數(1–32767)。

    return_code
    從這個呼叫返回的代碼。 本主題稍後會列出有效的傳回碼。

回傳代碼

CM_OK
主要傳回碼;成功執行的呼叫,而 string 參數現在包含已轉換的 EBCDIC 字串。

CM_OPERATION_NOT_ACCEPTED 操作未接受
主要傳回碼; string_length 參數指定了無效的值。

CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤,且已在產品錯誤記錄檔中記錄。

狀態變更

對話可以處於任何狀態。

沒有狀態變更。

備註

在基本會話中以緩衝區格式接收資料時,資料緩衝區可能包含多個邏輯記錄,每個記錄具有一個兩位元組長度欄位(NN),後面緊接著資料。 應用程式必須個別擷取和轉換每個數據字串(不包括長度域值)。 應用程式不得嘗試在一個作業中轉換整個緩衝區,因為這會使長度域值無效。