北京信城通数码科技有限公司
图 2.4-1
表示服务器已经准备好接收请求，服务器的配置信息见3.2的配置说明。 2. 在命令行下输入：casadtest.exe，应出现以下界面：
图 2.4-2
弹出选择证书的窗口，选择一个证书，然后点击“确定”按钮，会出现以下类似信息：
CAS6.0认证服务器-接口使用手册-V2.0 第 31 页 共 35 页
北京信城通数码科技有限公司
图 2.4-3
列出了获取的属性名（app.username和app.password）的属性值。 同时，服务器端的输出信息为：
图 2.4-4
3. 如果上面两步都成功，表示安装完成。
4. 可以用“3.3使用示例”代码验证PowerBuilder环境下运行是否正确。
CAS6.0认证服务器-接口使用手册-V2.0 第 32 页 共 35 页
北京信城通数码科技有限公司
4.3 接口说明
4.3.1 函数说明
4.3.1.1 C接口说明 4.3.1.1.1 登录CAS系统
方面 原型 说明 int WINAPI CAS_userLogin(const char*host, int port, int timeout) 返回值 成功（>=0）：本次会话的ID，保留使用 失败（<0）：错误码，请参见3.2节 参数 host：CAS地址 port：CAS端口号 timeout：超时时间，单位为秒 表3.1-1 4.3.1.1.2 登出CAS系统
方面 说明 原型 int WINAPI CAS_userLogout(int logcode) 返回值 成功（=0）： 失败（<0）：错误码，请参见3.2节 参数 logcode：正确登录时的返回值 表3.1-2 4.3.1.1.3 获取属性值
方面 原型 返回值 参数 说明 int WINAPI CAS_getAppAttribute (const char* appid, const char* attrib, char* buffer, int bufflen); 成功（>=0）：成功，返回字符串的长度或需要的空间。 失败（<0）：错误码，请参见3.2节 appid：应用标识，（本处指数据库） attrib：属性名字，（本处指用户名、口令） buffer：缓冲区，如果为空，则本函数返回需要的空间大小； bufflen：缓冲区的大小 表3.1-3 说明：
1． buffer为调用者分配的内存空间，由bufflen指定空间大小，包含字符串的结束符’\\0’。 2． 当buffer为NULL时，返回的空间要求可能比实际的要大一些。
4.3.1.2 PowerBuilder调用说明
在使用C接口的PowerBuilder脚本中需要声明为全局外部函数，其名称可以任意声明，例如（alias）,格式如下：
4.3.1.2.1 登录CAS系统
FUNCTION int CAS_userLogin(string host, int port, int timeout) LIBRARY \
4.3.1.2.2 登出CAS系统
FUNCTION int CAS_userLogout(int logcode) LIBRARY \
CAS6.0认证服务器-接口使用手册-V2.0 第 33 页 共 35 页
北京信城通数码科技有限公司
4.3.1.2.3 获取属性值
FUNCTION int CAS_getAppAttribute (string appid, string attrib, &REF string buffer, int bufflen) LIBRARY \
4.3.1.2.4 使用示例
在例子中都没有判断返回值，在实际使用中需要判断。 1) CAS_userLogin(\ 2) string stringBuffer 3) // read user name
4) stringBuffer = Space(100)
5) CAS_getAppAttribute(\\stringBuffer, 100) 6) MessageBox(\ 7) // read user password 8) stringBuffer = Space(100)
9) CAS_getAppAttribute(\\stringBuffer, 100) 10) MessageBox(\ 11) CAS_userLogout(100)
对以上操作的描述：
第一步，登录集中认证服务器，我们假定成功。 第四步，为缓存分配空间
第五步，获取用户名属性，我们假定成功。（此处的应用ID是一个测试值，不代表真正应
用的ID）
第六步，显示获得的用户名；
第九步，获取口令属性，我们假定成功。 第十步，显示获得的口令； 第十一步，退出登录。
4.3.2 返回码定义
>=0：成功
-10000：用户点击了证书选择对话框的“取消”按钮； -20000：没有找到颁发者； -20001：初始化出错； -20002：没有初始化环境； -20003：证书登录错误；
CAS6.0认证服务器-接口使用手册-V2.0 第 34 页 共 35 页
北京信城通数码科技有限公司
-20004：导入会话密钥错误； -20005：签名数据错误； -20006：验证签名错误； -20007：登录异常； -20008：摘要计算错误； -20009：加密数据错误； -20010：退出验证错误； -20011：未知异常； -20012：退出异常； -20013：获取应用属性错误； -20014：解密数据错误； -20015：获取应用属性异常； -20016：初始化加密模块错误； -20017：过多颁发者； -20018：缓存长度太小； -20019：有效期时间格式错误； -20020：提示过期天数格式错误； -20021：服务器证书错误； -20022：产生随机会话密钥错误； -20023：连接不到服务器错误；
5 技术支持及售后服务
用户对产品使用有任何疑问，可以参阅产品联机帮助手册；或直接下载最新手册http://www.itownet.cn/secit/manual/,用户也可以直接联系客户服务部,联系方式为： 热线电话：010-82863004-800 热线传真：010-63702800 联系邮箱：surport@itownet.cn 网络联系工具：surport@hotmail.cn
CAS6.0认证服务器-接口使用手册-V2.0 第 35 页 共 35 页