Extract_TP_Name

The Extract_TP_Name call (function name cmetpn) returns the TP_name characteristic.

CM_ENTRY Extract_TP_Name(
  unsigned char FAR *conversation_ID,  
  unsigned char FAR *TP_name,          
  CM_INT32 FAR *TP_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.

TP_name

Returned parameter. Specifies the variable containing the TP name.

TP_name_length

Returned parameter. Specifies the length of the TP 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.

Remarks

For an invoking program, the TP_name characteristic is the value in the side information referenced in the sym_dest_name parameter of the Initialize_Conversation call. For an invokable program, it is the name specified in the conversation startup request (which will have been matched with a name specified locally or in a Specify_Local_TP_Name call), and will therefore be the same as the TP_name characteristic of the partner program.

The name returned can be up to 64 bytes in length.