Extract_TP_Name (CPI-C)

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

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 è stata 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ò essere in qualsiasi stato, ad eccezione di RESET.

Non è presente alcuna modifica dello stato.

Commenti

Per un programma di richiamo, la TP_name caratteristica è il valore nelle informazioni sul lato a cui si fa riferimento nel parametro sym_dest_name della Initialize_Conversation chiamata. Per un programma invokable, è il nome specificato nella richiesta di avvio della conversazione (che corrisponderà a 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.