The call Extract_Partner_LU_Name_Ex (CMEPLNX) provides the program with the current partner_LU_name for the conversation at full length.
This call is one of the advanced functions.
Note
The call Extract_Partner_LU_Name returns names with a maximum length of 32 bytes.
CMEPLNX(conversation_ID, partner_LU_name, requested_length,partner_LU_name_length, return_code)
Parameter
--> conversation_ID | Identification of the conversation. |
<-- partner_LU_name | Returns the partner_LU_name. |
--> requested_length | Maximum length of partner_LU_name that can be received. |
<-- partner_LU_name_length | Specifies the length of the value supplied in partner_LU_name. The value of partner_LU_name_length is undefined if the return code is different than CM_OK. Minimum: 1, Maximum: 73. |
<-- return_code | Result of the function call. |
Result (return_code)
CM_OK
Call OK
CM_PROGRAM_PARAMETER_CHECK
The value in conversation_ID is invalid or requested_length is not large enough to receive the partner_LU_name.
CM_PRODUCT_SPECIFIC_ERROR
The UPIC instance could not be found.
CM_PROGRAM_STATE_CHECK
The conversation is not in “Initialize” state.
State change
The call does not change the state of the conversation.
Note
If the return code is different than CM_OK the value of partner_LU_name has no meaning.
Behavior in the event of errors
CM_PROGRAM_PARAMETER_CHECK
Modify program.
CM_PRODUCT_SPECIFIC_ERROR
The operating system cannot provide sufficient memory for internal buffers. Check whether the memory requirement of your program is too high and if necessary reboot your system.
CM_PROGRAM_STATE_CHECK
Modify program.
CM_ENTRY Extract_Partner_LU_Name_Ex (unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR partner_LU_name,
CM_INT32 CM_PTR requested_length,
CM_INT32 CM_PTR partner_LU_name_length,
CM_RETURN_CODE CM_PTR return_code)