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),後面緊接著資料。 應用程式必須個別擷取和轉換每個數據字串(不包括長度域值)。 應用程式不得嘗試在一個作業中轉換整個緩衝區,因為這會使長度域值無效。