Extract_Conversation_Security_Type (CPI-C)

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_ConversationAccept_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 以外的任何状态。

没有状态更改。