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

CPI-C Calls
Extract_CPIC_Side_Information (xcmesi)
Chapter 3 171
side_info_entry.security_user_ID User ID used to access the
partner TP. This parameter is not required if the
conversation_security_type parameter is set to
XC_SECURITY_NONE.
For compatibility with X/Open CPI-C, this verb only
returns eight characters for the user ID, although
security user IDs can be up to 10 characters. To ensure
that you obtain the complete user ID, you should
extract it explicitly using the
Extract_Security_User_ID call
(Extract_Conversation_Security_User_ID for Windows
systems), instead of relying on the value returned here.
side_info_entry.security_password This parameter is reserved;
password information is never returned to the
application.
return_code Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK One of the following
has occurred:
• The sym_dest_name parameter is
not valid
• The side_info_entry_length
parameter is not set to
sizeof(SIDE_INFO)()
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.”
State When Issued
This call is not associated with a conversation.
State Change
There is no state change.