Extract_Conversation_Security_User_ID (CPI-C)
Extract_Conversation_Security_User_ID调用 (函数名称 cmecsu) 返回指定会话中使用的用户标识符。
语法
CM_ENTRY Extract_Conversation_Security_User_ID(
unsigned char FAR *conversation_ID,
unsigned char FAR *security_user_ID,
CM_INT32 FAR *security_user_ID_length,
CM_INT32 FAR *return_code
);
参数
conversation_ID
提供的参数。 指定会话的标识符。 此参数的值由 Initialize_Conversation 或 Accept_Conversation 返回。
security_user_ID
返回的参数。 指定用于建立会话的用户标识符。
security_user_ID_length
返回的参数。 指定 security_user_ID的长度。
return_code
从此调用返回的代码。 本主题后面列出了有效的返回代码。
返回代码
CM_OK
主返回代码;调用已成功执行。
CM_PROGRAM_PARAMETER_CHECK
主返回代码; 由 conversation_ID 指定的值无效。
状态更改
会话可以处于除 RESET 之外的任何状态。
没有状态更改。
注解
security_user_ID值未填充空格。 只有 security_user_ID_length才有意义。