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

CPI-C Calls

Set_Conversation_Security_Password (cmscsp)

Chapter 3232

Set_Conversation_Security_Password

(cmscsp)

The Set_Conversation_Security_Password call is issued by the invoking

program to specify the password required to access the invoked program.

This call has an effect on the conversation only if the conversation

security type is CM_SECURITY_PROGRAM or

CM_SECURITY_PROGRAM_STRONG (HP-UX systems), or

XC_SECURITY_PROGRAM (Windows systems). It overrides the initial

password from the side information speciﬁed by the

Initialize_Conversation call. This call cannot be issued after the Allocate

call has been issued.

Function Call

void cmscsp (

unsigned char CM_PTR conversation_ID,

unsigned char CM_PTR security_password,

CM_INT32 CM_PTR security_password_length,

CM_RETURN_CODE CM_PTR return_code

);

Function Call for Java CPI-C

public native void cmscsp (

byte[] conversation_ID,

byte[] security_password,

CPICLength security_password_length,

CPICReturnCode return_code

);

Supplied Parameters

The supplied parameters are:

conversation_ID

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

this parameter is returned by the

Initialize_Conversation call.