Extract_TP_Name (CPI-C)

La chiamata Extract_TP_Name ( nome funzione cmetpn) restituisce la caratteristica TP_name .

Sintassi

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

Parametri

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

Tp_name
Parametro restituito. Specifica la variabile contenente il nome del programma di transazione ( TP).

TP_name_length
Parametro restituito. Specifica la lunghezza del nome TP.

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

Per un programma di richiamo, la caratteristica TP_name è il valore nelle informazioni laterali a cui si fa riferimento nel parametro sym_dest_name della chiamata Initialize_Conversation . Per un programma richiamabile, è il nome specificato nella richiesta di avvio della conversazione (che sarà stato confrontato con un nome specificato in locale o in una chiamata Specify_Local_TP_Name ) e sarà quindi uguale alla caratteristica TP_name del programma partner.

Il nome restituito può avere una lunghezza massima di 64 byte.