Extract_TP_Name (CPI-C)

La llamada Extract_TP_Name (nombre de función cmetpn) devuelve la característica TP_name .

Sintaxis

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

Parámetros

conversation_ID
Parámetro proporcionado. Especifica el identificador de la conversación. El valor de este parámetro lo devolvió Initialize_Conversation o Accept_Conversation.

TP_name
Parámetro devuelto. Especifica la variable que contiene el nombre del programa de transacciones (TP).

TP_name_length
Parámetro devuelto. Especifica la longitud del nombre de TP.

return_code
Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; el valor especificado por conversation_ID no es válido.

CM_PRODUCT_SPECIFIC_ERROR
Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

Cambios de estado

La conversación puede estar en cualquier estado excepto RESET.

No hay ningún cambio de estado.

Comentarios

Para un programa de invocación, la característica TP_name es el valor de la información lateral a la que se hace referencia en el parámetro sym_dest_name de la llamada Initialize_Conversation . Para un programa invocable, es el nombre especificado en la solicitud de inicio de conversación (que se habrá emparejado con un nombre especificado localmente o en una llamada de Specify_Local_TP_Name ) y, por lo tanto, será el mismo que la característica TP_name del programa asociado.

El nombre devuelto puede tener hasta 64 bytes de longitud.