Extract_Convertion - Wert der Conversation Characteristic CHARACTER_CONVERTION abfragen

Mit dem Aufruf Extract_Convertion (CMECNV) erhält ein Programm den aktuellen Wert für die Characteristic CHARACTER_CONVERTION der Conversation.

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

Der Aufruf Extract_Convertion ist nur im Zustand "Initialize" erlaubt.

Syntax

CMECNV (conversation_ID, character_convertion, return_code)

Parameter

--> conversation_ID	Identifikation der Conversation.
<-- character_convertion	der Wert gibt an, ob eine Code-Konvertierung der Benutzerdaten durchgeführt wird oder nicht. Für character_convertion können folgende Werte zurückgegeben 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 ist ungültig.

CM_PRODUCT_SPECIFIC_ERROR

Die UPIC Instanz konnte nicht gefunden werden (Interner Fehler).

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 CHARACTER_CONVERTION 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 grosse Speicherplatzanforderung und starten Sie ggf. Ihr System neu.

Funktionsdeklaration: Extract_Convertion

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