Extract_Conversation_Security_Type调用(函数名称 xcecst)返回指定会话的安全类型。
语法
CM_ENTRY Extract_Conversation_Security_Type(
unsigned char FAR *conversation_ID,
CM_INT32 FAR *conversation_security_type,
CM_INT32 FAR *return_code
);
参数
conversation_ID
提供的参数。 指定会话的标识符。 此参数的值由 Initialize_Conversation 或 Accept_Conversation返回。
conversation_security_type
返回的参数。 指定合作伙伴逻辑单元(LU)需要验证对已调用程序的访问权限的信息。 可能的值为:
CM_SECURITY_NONE
调用的程序不使用会话安全性。
CM_SECURITY_PROGRAM
调用的程序使用会话安全性,因此需要用户标识符和密码。
CM_SECURITY_SAME
调用的程序使用有效的用户标识符和密码调用,进而调用另一个程序(如 TP 之间的通信所示)。 例如,假设程序 A 调用具有有效用户标识符和密码的程序 B,而程序 B 又调用程序 C。如果程序 B 指定值CM_SECURITY_SAME,CPI-C 发送程序 C 的 LU、程序 A 中的用户标识符和已验证的指示器。 此指示器告知程序 C 不需要密码(如果程序 C 配置为接受已验证的指示器)。
return_code
从此调用返回的代码。 本主题后面列出了有效的返回代码。
返回代码
CM_OK
主要返回代码;调用已成功执行。
CM_PROGRAM_PARAMETER_CHECK
主要返回代码; 由conversation_ID 指定的值无效,或者变量的地址无效。
状态更改
对话可以处于除 RESET 之外的任何状态。
没有状态更改。