Der Aufruf Set_Sync_Level (CMSSL) setzt den Wert für die Characteristic sync_level einer Conversation. Der Aufruf überschreibt den Wert, der beim Initialize_Conversation-Aufruf zugewiesen wurde.
Der Set_Sync_Level-Aufruf darf nach dem Allocate-Aufruf nicht mehr ausgeführt werden.
Diese Funktion gehört zu den Advanced Functions.
CMSSL (conversation_ID, sync_level, return_code)
Parameter
--> conversation_ID | Identifikation der Conversation |
--> sync_level | gibt die Stufe der Synchronisation an, die das lokale CPI-C-Programm und die entfernteUTM-Anwendung über diese Conversation benutzen können. sync_level muss den Wert CM_NONE haben. |
<-- return_code | Ergebnis des Funktionsaufrufs |
Ergebnis (return_code)
CM_OK
Aufruf ok
CM_PROGRAM_STATE_CHECK
Die Conversation ist nicht im Zustand "Initialize".
CM_PROGRAM_PARAMETER_CHECK
Der Wert in conversation_ID ist ungültig oder der Wert in sync_level ist undefiniert.
CM_PRODUCT_SPECIFIC_ERROR
Die UPIC-Instanz konnte nicht gefunden werden.
Zustandsänderung
Im fehlerfreien Fall liefert die Funktion das Ergebnis CM_OK zurück. Dieser Aufruf ändert den Zustand der Conversation nicht.
Hinweis
Der Aufruf dient lediglich der besseren Portierbarkeit von existierenden CPI-C-Programmen. Selbst wenn er CM_OK zurückliefert, ändert sich sync_level nicht. UPIC verwendet intern immer "sync_level=CM_NONE".
Verhalten im Fehlerfall
CM_PROGRAM_STATE_CHECK
Programm ändern.
CM_PROGRAM_PARAMETER_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 Set_Sync_ Level ( unsigned char CM_PTR conversation_ID,
CM_SYNC_LEVEL CM_PTR sync_level,
CM_RETURN_CODE CM_PTR return_code )