Extract_Partner_LU_Name (CPI-C)

La chiamata Extract_Partner_LU_Name (nome funzione cmepln) restituisce il nome lu partner e la lunghezza del nome LU del partner per una conversazione specificata. Può trattarsi di un nome alias di un massimo di otto byte o di un nome di rete completo di un massimo di 17 byte.

Sintassi

  
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              
);  

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation o Accept_Conversation.

partner_LU_name
Parametro restituito. Specifica la variabile contenente il nome lu partner. Il programma deve fornire un puntatore a una variabile appropriata.

partner_LU_name_length
Parametro restituito. Specifica la lunghezza del nome lu partner.

return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; il valore specificato da conversation_ID non è valido.

CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione può trovarsi in qualsiasi stato, ad eccezione di RESET.

Non esiste alcuna modifica dello stato.

Commenti

Un programma di transazione CPI-C richiamabile riceverà solo il nome di rete completo al completamento di questa chiamata di funzione. Un TP CPI-C richiamabile non è in grado di recuperare il nome dell'alias usando questa chiamata.