Extract_Partner_LU_Name (CPI-C)

El Extract_Partner_LU_Name llamada (nombre de función cmepln) devuelve el nombre de LU del asociado y la longitud del nombre de LU del asociado para una conversación especificada. Puede ser un nombre de alias de hasta ocho bytes o un nombre de red completo de hasta 17 bytes.

Sintaxis

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

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.

partner_LU_name
Parámetro devuelto. Especifica la variable que contiene el nombre de LU del asociado. (El programa debe proporcionar un puntero a una variable adecuada).

partner_LU_name_length
Parámetro devuelto. Especifica la longitud del nombre de LU del asociado.

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

Un programa de transacciones CPI-C invocable (TP) solo recibirá el nombre de red completo tras completar correctamente esta llamada de función. Un TP CPI-C invocable no puede recuperar el nombre del alias mediante esta llamada.