共用方式為

Convert_Incoming (CPI-C)

  • 發行項

Convert_Incoming呼叫 ( 函式名稱 cmcnvi) 將 EBCDIC 字元字串轉換成 ASCII。 請注意，可以使用 Convert_Outgoing 來執行傳回轉換。

語法

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

參數

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

  • 大寫 A–Z

  • 小寫 a–z

  • 數位 0–9

  • 句號 (.)

  • 空格符

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

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

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

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

傳回碼

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

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

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

狀態變更

交談可以處於任何狀態。

沒有狀態變更。

備註

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