Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La llamada Extract_Partner_LU_Name (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.
Observaciones
Una CPI-C programa de transacciones (TP) invocable solo recibirá el nombre de red completo tras la finalización correcta de esta llamada de función. Un CPI-C TP invocable no puede recuperar el nombre del alias mediante esta llamada.