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
主要傳回碼;成功執行的呼叫， 而 string 參數現在包含已轉換的 EBCDIC 字串。

CM_OPERATION_NOT_ACCEPTED
主要傳回碼; string_length 參數指定了無效的值。

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

狀態變更

交談可以處於任何狀態。

沒有狀態變更。

備註

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