Extract_Conversation_State (CPI-C)

  • Articolo

La chiamata Extract_Conversation_State ( nome funzione cmecs) restituisce lo stato della conversazione specificata.

Sintassi

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

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation o Accept_Conversation.

conversation_state
Parametro restituito. Specifica lo stato della conversazione. I valori possibili sono:

  • 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
    Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; il valore specificato da conversation_ID non è valido.

CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione può trovarsi in qualsiasi stato, ad eccezione di RESET.

Non esiste alcuna modifica dello stato.