Calling Extract_Max_Partner_Index (CMEPIN) provides the program with the number of partner applications in the partner applications list, i.e. the highest index set with Set_Partner_Index()
This function is one of the additional functions of the UPIC carrier system; it is not part of the CPI-C interface.
UPIC-Local on Unix, Linux and Windows Systems:
The call Extract_Max_Partner_Index is not supported for a connection using UPIC-L.
CMEPIN (conversation_ID, partner_index, return_code)
Parameter
--> conversation_ID | Identification of the conversation |
<-- partner_index | Returns the maximum index for a list of partner applications. Minimum: 1 |
<-- return_code | Result of the function call |
Result (return_code)
CM_OK
Call ok
CM_CALL_NOT_SUPPORTED
This return code only applies to Unix, Linux and Windows systems.
The function is not supported. This return code only occurs with UPIC-L.
CM_PROGRAM_PARAMETER_CHECK
The value of the conversation_ID is invalid.
CM_PROGRAM_STATE_CHECK
The conversation is not in "Initialize” state.
CM_PRODUCT_SPECIFIC_ERROR
The UPIC instance could not be found or there is a memory bottleneck.
State change
The call does not change the state of the conversation.
Behavior in the event of errors
CM_CALL_NOT_SUPPORTED
This return code only applies to Unix, Linux and Windows systems.
Normal behavior if the application is linked to a UPIC-L library.
CM_PROGRAM_PARAMETER_CHECK
Modify program.
CM_PROGRAM_STATE_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_ENTRY Extract_Max_Partner_Index( unsigned char CM_PTR conversation_ID,
CM_INT32 CM_PTR partner_index,
CM_RETURN_CODE CM_PTR return_code )