Extract_TP_Name (CPI-C)

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

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 tp.

return_code
Código devuelto por 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 registró 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.

Observaciones

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

El nombre devuelto puede tener una longitud de hasta 64 bytes.