Mit dem Aufruf Extract_Max_Partner_Index (CMEPIN) erhält ein Programm die Anzahl der Partner-Anwendungen in der Liste der Partner-Anwendungen, d.h. den höchsten mit Set_Partner_Index gesetzten Index.
Diese Funktion gehört zu den zusätzlichen Funktionen des Trägersystems UPIC; sie ist nicht Bestandteil der CPI-C-Schnittstelle.
UPIC-Local auf Unix-, Linux- und Windows-Systemen:
Der Aufruf Extract_Max_Partner_Index wird bei der Anbindung über UPIC-L nicht unterstützt.
CMEPIN (conversation_ID, partner_index, return_code)
Parameter
--> conversation_ID | Identifikation der Conversation |
<-- partner_index | Gibt den maximalen Index für eine Liste von Partner-Anwendungen zurück. Minimum: 1 |
<-- return_code | Ergebnis des Funktionsaufrufs |
Ergebnis (return_code)
CM_OK
Aufruf ok
CM_CALL_NOT_SUPPORTED
Dieser Returncode gilt nur für Unix-, Linux- und Windows-Systeme.
Die Funktion wird nicht unterstützt. Dieser Returncode tritt nur bei UPIC-L auf.
CM_PROGRAM_PARAMETER_CHECK
Der Wert der conversation_ID ist ungültig.
CM_PROGRAM_STATE_CHECK
Die Conversation ist nicht im Zustand "Initialize".
CM_PRODUCT_SPECIFIC_ERROR
Die UPIC-Instanz konnte nicht gefunden werden oder Speicherengpass.
Zustandsänderung
Der Aufruf ändert den Zustand der Conversation nicht.
Verhalten im Fehlerfall
CM_CALL_NOT_SUPPORTED
Dieser Returncode gilt nur für Unix-, Linux- und Windows-Systeme.
Normales Verhalten, falls die Anwendung mit einer UPIC-L-Bibliothek gebunden ist.
CM_PROGRAM_PARAMETER_CHECK
Programm ändern.
CM_PROGRAM_STATE_CHECK
Programm ändern.
CM_PRODUCT_SPECIFIC_ERROR
Das Betriebssystem kann nicht genügend Speicherplatz für interne Puffer bereitstellen. Überprüfen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf. Ihr System neu.
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 )