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

CPI-C Calls

Extract_Conversation_Context (cmectx)

Chapter 3156

Extract_Conversation_Context (cmectx)

For Unix The Extract_Conversation_Context call returns the context for a

speciﬁed conversation. This enables the program to set its current

context to the required value (using Set_Conversation_Context) before

starting a new conversation, to ensure that the new conversation uses

the same context.

Function Call

void cmectx (

unsigned char CM_PTR conversation_ID,

unsigned char CM_PTR context_ID,

CM_INT32 CM_PTR context_ID_length,

CM_RETURN_CODE CM_PTR return_code

);

Function Call for Java CPI-C

public native void cmectx (

byte[] conversation_ID,

byte[] context_ID,

CPICLength context_ID_length,

CPICReturnCode return_code

);

Supplied Parameters

The supplied parameter is:

conversation_ID

This is the identiﬁer for the conversation. The value of

this parameter was returned by the

Initialize_Conversation, Initialize_For_Incoming, or

Accept_Conversation call.

Returned Parameters

After the verb executes, SNAplus2 returns parameters to indicate

whether the execution was successful and, if not, to indicate the reason

the execution was unsuccessful.