Extract_Conversation_State - Zustand der Conversation abfragen

Mit dem Aufruf Extract_Conversation_State (CMECS) erhält ein Programm den aktuellen Zustand der Conversation.

Syntax

CMECS (conversation_ID, conversation_state, return_code)

Parameter

<-- conversation_state	Der Wert enthält den Zustand der Conversation. Gültige Werte für UPIC sind: CM_INITIALIZE_STATE CM_SEND_STATE CM_RECEIVE_STATE
<-- return_code	Ergebnis des Funktionsaufrufes

Ergebnis (return_code)

CM_OK

Aufruf OK

CM_PROGRAM_PARAMETER_CHECK

Der Wert der conversation_ID ist ungültig.

CM_PRODUCT_SPECIFIC_ERROR

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

Zustandsänderung

Der Aufruf ändert den Zustand der Conversation nicht.

Hinweis

• Falls der Returncode von CM_OK verschieden ist, hat der Wert von conversation_state keine Bedeutung.

• In den Zuständen "Start" und "Reset" existiert nie eine gültige conversation_ID.

Verhalten im Fehlerfall

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: Extract_Conversation_State

CM_ENTRY Extract_Conversation_State (unsigned char CM_PTR conversation_ID,
                             CM_CONVERSATION_STATE CM_PTR conversation_state,
                             CM_RETURN_CODE        CM_PTR return_code )