Extract_Mode_Name (CPI-C)

Extract_Mode_Name调用 (函数名称 cmemn) 返回指定会话的模式名称和模式名称长度。

语法

  
CM_ENTRY Extract_Mode_Name(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *mode_name,      
  CM_INT32 FAR *mode_name_length,    
  CM_INT32 FAR *return_code          
);  

参数

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

mode_name
返回的参数。 指定模式名称的起始地址。

mode_name_length
返回的参数。 指定模式名称的长度。

return_code
此调用返回的代码。 本主题稍后将列出有效的返回代码。

返回代码

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

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

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

状态更改

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

没有状态更改。