HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
Extract_Conversation_Context (cmectx)
Chapter 3 157
context_ID This parameter contains the context of the specified
conversation. It is valid only if the return_code
parameter is CM_OK.
context_ID_length This parameter contains the length of context_ID
(1–32 bytes). It is valid only if the return_code
parameter is CM_OK.
return_code Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK The value specified by
conversation_ID is not valid.
CM_PROGRAM_STATE_CHECK The conversation specified
by conversation_ID is in Initialize
or Initialize-Incoming state.
For an explanation of the following return code, see
Appendix A, “Common Return Codes.”
CM_PRODUCT_SPECIFIC_ERROR
State When Issued
The conversation can be in any state except Reset, Initialize, or
Initialize-Incoming.
State Change
There is no state change.
Usage Notes
This call does not set the program's current context to the extracted
value. The program must call Set_Conversation_Context to do this.
An application uses Extract_Conversation_Context, followed by
Set_Conversation_Context, in the following situations:
• When it is involvedin multiple conversations, and wantsto allocate a
new conversation using the same context as an existing
conversation.