共用方式為

Extract_CPIC_Side_Information (CPI-C)

  • 發行項

Extract_CPIC_Side_Information呼叫 (函式名稱xcmesi) 會傳回專案號碼或符號目的地名稱的側邊資訊。

語法

  
CM_ENTRY Extract_CPIC_Side_Information(   
  CM_INT32 FAR *entry_number,          
  unsigned char FAR *sym_dest_name,    
  SIDE_INFO FAR *side_info_entry,      
  CM_INT32 FAR *side_info_entry_length,    
    CM_INT32 FAR *return_code            
);

參數

entry_number
提供的 參數。 指定要傳回之側資訊專案) (索引的數目。 第一個專案是 1。

程式可以改為依符號目的地名稱查閱側邊資訊專案。 若要達成此目的，請將專案編號設定為零。

sym_dest_name
提供的 參數。 指定要搜尋的符號目的地名稱。

如果 entry_number 設定為大於零的數位，則會忽略此參數。

side_info_entry
傳回的參數。 指定側邊資訊專案。 如需側邊資訊專案的詳細說明，請參閱 Set_CPIC_Side_Information。

側邊資訊結構中的每個欄位都會靠左對齊，並視需要填補右邊的空格。

side_info_entry_length
提供的 參數。 一律為 124。

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

傳回碼

CM_OK
主要傳回碼;已成功執行呼叫。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項：

  • entry_number指定的數位大於側邊資訊表中專案的最大數目，或小於零的數位。

  • sym_dest_name參數無效，entry_number設定為零。

  • side_info_entry_length參數未設定為 124。

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

狀態變更

此呼叫與交談無關，而且可以處於任何狀態。

沒有狀態變更。

備註

永遠不會傳回安全性密碼。 如果未設定側邊資訊中的安全性使用者識別碼，則會以所有空格傳回安全性使用者識別碼欄位。