Compartir a través de

Extract_Conversation_State (CPI-C)

  • Artículo

La llamada Extract_Conversation_State (nombre de función cmecs) devuelve el estado de la conversación especificada.

Sintaxis

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

Parámetros

conversation_ID
Parámetro proporcionado. Especifica el identificador de la conversación. El valor de este parámetro lo devolvió Initialize_Conversation o Accept_Conversation.

conversation_state
Parámetro devuelto. Especifica el estado de la conversación. Los valores posibles son:

  • 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
    Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; el valor especificado por conversation_ID no es válido.

CM_PRODUCT_SPECIFIC_ERROR
Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

Cambios de estado

La conversación puede estar en cualquier estado excepto RESET.

No hay ningún cambio de estado.