Extract_Partner_LU_Name (CPI-C)

Extract_Partner_LU_Name呼叫 (函式名稱cme) 傳回指定交談的夥伴 LU 名稱和夥伴 LU 名稱長度。 這可以是最多八個位元組的別名名稱，或最多 17 個位元組的完整網路名稱。

語法

  
CM_ENTRY Extract_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_name_length,    
  CM_INT32 FAR *return_code              
);  

參數

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

partner_LU_name
傳回的參數。 指定包含夥伴 LU 名稱的變數。 (程式必須提供適合變數的指標。)

partner_LU_name_length
傳回的參數。 指定夥伴 LU 名稱的長度。

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

傳回碼

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

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

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

狀態變更

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

沒有狀態變更。

備註

可叫用的 CPI-C 交易程式 (TP) 只會在成功完成此函式呼叫時收到完整的網路名稱。 可叫用的 CPI-C TP 無法使用這個呼叫來擷取別名名稱。