Extract_Mode_Name
The Extract_Mode_Name call (function name cmemn) returns the mode name and mode name length for a specified conversation.
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
);
Parameters
-
conversation_ID
-
Supplied parameter. Specifies the identifier for the conversation. The value of this parameter was returned by Initialize_Conversation or Accept_Conversation.
-
mode_name
-
Returned parameter. Specifies the starting address of the mode name.
-
mode_name_length
-
Returned parameter. Specifies the length of the mode name.
-
return_code
-
The code returned from this call. The valid return codes are listed below.
Return Codes
-
cm_ok
-
Primary return code; the call executed successfully.
-
cm_program_parameter_check
-
Primary return code; the value specified by conversation_ID is invalid.
-
cm_product_specific_error
-
Primary return code; a product-specific error occurred and has been logged in the product's error log.
State Changes
The conversation can be in any state except RESET.
There is no state change.