Extract_Conversation_State (CPI-C)

Extract_Conversation_State调用 (函数名称 cmecs) 返回指定会话的状态。

语法

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

参数

conversation_ID
提供的参数。 指定会话的标识符。 此参数的值由 Initialize_ConversationAccept_Conversation 返回。

conversation_state
返回的参数。 指定会话状态。 可能的值为:

  • 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
    从此调用返回的代码。 本主题后面列出了有效的返回代码。

返回代码

CM_OK
主返回代码;调用已成功执行。

CM_PROGRAM_PARAMETER_CHECK
主返回代码; 由 conversation_ID 指定的值无效。

CM_PRODUCT_SPECIFIC_ERROR
主返回代码;发生特定于产品的错误,并且已记录在产品错误日志中。

状态更改

会话可以处于除 RESET 之外的任何状态。

没有状态更改。