Freigeben über

Extract_Conversation_State (CPI-C)

  • Artikel

Der Extract_Conversation_State Aufruf (Funktionsname cmecs) gibt den Zustand der angegebenen Unterhaltung zurück.

Syntax

  
CM_ENTRY Extract_Conversation_State(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *conversation_state,    
  CM_INT32 FAR *return_code            
);

Parameter

conversation_ID
Angegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Der Wert dieses Parameters wurde von Initialize_Conversation oder Accept_Conversation zurückgegeben.

conversation_state
Zurückgegebener Parameter. Gibt den Unterhaltungszustand an. Mögliche Werte:

  • CM_INITIALIZE_STATE

  • CM_SEND_STATE

  • CM_RECEIVE_STATE

  • CM_SEND_PENDING_STATE

  • CM_CONFIRM_STATE

  • CM_CONFIRM_SEND_STATE

  • CM_CONFIRM_DEALLOCATE_STATE

    return_code
    Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; Der durch conversation_ID angegebene Wert ist ungültig.

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung kann sich in einem beliebigen Zustand mit Ausnahme von RESET befinden.

Es gibt keine Zustandsänderung.