Set_Convertion - Setzen der Conversation Characteristic CHARACTER_CONVERTION

Der Aufruf Set_Convertion (CMSCNV) setzt für die Conversation die Characteristic CHARACTER_CONVERTION.

Set_Convertion ändert die Werte, die beim Initialize_Conversation-Aufruf aus der Side Information entnommen wurden. Die geänderten Werte gelten nur für die Dauer einer Conversation; die Werte in der Side Information selbst werden nicht verändert.

Der Set_Convertion-Aufruf darf nach Allocate nicht mehr ausgeführt werden.

Diese Funktion gehört zu den zusätzlichen Funktionen des Trägersystems UPIC; sie ist nicht Bestandteil der CPI-C-Schnittstelle.

Syntax

CMSCNV (conversation_ID, character_convertion, return_code)

Parameter

--> conversation_ID	Identifikation der Conversation
--> character_convertion	legt fest, ob eine Code-Konvertierung der Benutzerdaten durchgeführt werden soll oder nicht. Für character_convertion können folgende Werte gesetzt werden: CM_NO_CHARACTER_CONVERTION Es findet keine automatische Code-Konvertierung beim Senden oder Empfangen von Daten statt. CM_IMPLICIT_CHARACTER_CONVERTION Beim Senden und Empfangen von Daten werden die Daten automatisch konvertiert (siehe auch Abschnitt „Code-Konvertierung“).
<-- return_code	Ergebnis des Funktionsaufrufes

Ergebnis (return_code)

CM_OK

Aufruf OK

CM_PROGRAM_PARAMETER_CHECK

Der Wert in conversation_ID oder der Wert für CHARACTER_CONVERTION ist ungültig.

CM_PRODUCT_SPECIFIC_ERROR

Die UPIC-Instanz konnte nicht gefunden werden.

CM_PROGRAM_STATE_CHECK

Die Conversation ist nicht im Zustand “Initialize”

Zustandsänderung

Der Aufruf ändert den Zustand der Conversation nicht.

Hinweis

Falls der Returncode von CM_OK verschieden ist, bleibt die Characteristic unverändert.

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.

Funktionsdeklaration: Set_Convertion

CM_ENTRY Set_Convertion( 
                  unsigned char                  CM_PTR  conversation_ID, 
                  CM_CHARACTER_CONVERTION_TYPE   CM_PTR  convertion_type,
                  CM_RETURN_CODE                 CM_PTR  return_code )