Extract_TP_Name （CPI-C）

Extract_TP_Name呼叫 （函 式 名稱 cmetpn） 會傳回 TP_name 特性。

語法

  
CM_ENTRY Extract_TP_Name(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *TP_name,            
  CM_INT32 FAR *TP_name_length,          
  CM_INT32 FAR *return_code              
);  

參數

conversation_ID
提供的參數。 指定交談的標識碼。 此參數的值是由 Initialize_Conversation 或 Accept_Conversation 所傳回。

TP_name
傳回的參數。 指定包含交易程式 （TP） 名稱的變數。

TP_name_length
傳回的參數。 指定 TP 名稱的長度。

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

回傳代碼

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

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼; conversation_ID 指定的值無效。

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

狀態變更

交談可以是 RESET 以外的任何狀態。

沒有狀態變更。

備註

對於叫用程式，TP_name特性是Initialize_Conversation呼叫之 sym_dest_name 參數中所參考的側邊資訊值。 對於可叫用的程式，它是對話啟動要求中指定的名稱（其會與本機或 Specify_Local_TP_Name 呼叫中指定的名稱相符），因此會與夥伴計劃 TP_name 特性相同。

傳回的名稱長度最多可達64個字節。