格尔签名验证客户端(应用服务器)API_C_ActiveX接口说明讲述.docVIP

格尔签名验证服务器 客户端API_C/ActiveX 接口说明 V1.7 上海格尔软件股份有限公司 2006年8月 保密事宜： 本文档包含上海格尔软件股份有限公司的专有商业信息和保密信息。 接受方同意维护本文档所提供信息的保密性，承诺不对其进行复制，或向评估小组以外、非直接相关的人员公开此信息。对于以下三种信息，接受方不向格尔公司承担保密责任： 1 ) 接受方在接收该文档前，已经掌握的信息。 2 ) 可以通过与接受方无关的其它渠道公开获得的信息。 3 ) 可以从第三方，以无附加保密要求方式获得的信息。 目 录 1 接口说明 6 1.1 客户端初始化 6 1.2 客户端清理 6 1.3 验证数据签名 6 1.4 验证签名数据和签名证书 7 1.5 验证Attach方式的PKCS7数据签名 8 1.6 验证Attach方式的PKCS7数据签名并获取原文 9 1.7 证书验证 9 1.8 获取证书信息 10 1.9 Attach方式PKCS7数据签名 11 1.10 数据签名（普通签名数据） 11 1.11 对文件签名 12 1.12 对文件签名数据验证签名 13 1.13 对文件解密数字信封 14 1.14 Detach方式的PKCS#7签名 14 1.15 验证Detach方式的PKCS#7数据签名 15 1.16 验证签名（实时从LDAP下载证书并验证） 15 1.17 验证原文HASH签名 16 2 错误码说明 17 3 消息格式定义 23 3.1 消息格式总体描述 23 3.2 验证数据签名 24 3.2.1 客户端消息请求格式 24 3.2.2 服务器端验证签名成功的返回消息格式 25 3.2.3 服务器端验证签名失败的返回消息格式 25 3.3 验证签名数据和签名证书 26 3.3.1 客户端消息请求格式 26 3.3.2 服务器端验证签名成功的返回消息格式 27 3.3.3 服务器端验证签名失败的返回消息格式 27 3.4 验证PKCS#7签名数据 28 3.4.1 客户端消息请求格式 28 3.4.2 服务器端验证签名成功的返回消息格式 28 3.4.3 服务器端验证签名失败的返回消息格式 29 3.5 证书验证 29 3.5.1 客户端消息请求的格式 29 3.5.2 服务器端验证成功的返回消息格式 30 3.5.3 服务器端验证失败的返回消息格式 30 3.6 获取证书信息 31 3.6.1 客户端消息请求格式 31 3.6.2 服务器端解析证书成功的返回消息格式 31 3.6.3 服务器端解析证书失败的返回消息格式 32 3.7 数据签名（PKCS#7签名数据） 32 3.7.1 客户端消息请求格式 32 3.7.2 服务器端签名成功的返回消息格式 33 3.7.3 服务器端签名失败的返回消息格式 33 3.8 数据签名（普通签名数据） 34 3.8.1 客户端消息请求格式 34 3.8.2 服务器端签名成功的返回消息格式 35 3.8.3 服务器端签名失败的返回消息格式 35 3.9 对文件签名 36 3.9.1 客户端消息请求格式 36 3.9.2 服务器端签名成功的返回消息格式 36 3.9.3 服务器端签名失败的返回消息格式 37 3.10 对文件签名数据验证签名 37 3.10.1 客户端消息请求格式 37 3.10.2 服务器端验证签名成功的返回消息格式 38 3.10.3 服务器端验证签名失败的返回消息格式 38 3.11 对文件解密数字信封 39 3.11.1 客户端消息请求格式 39 3.11.2 服务器端操作成功的返回消息格式 40 3.11.3 服务器端操作失败的返回消息格式 40 3.12 验证签名（实时从LDAP下载证书并验证） 41 3.12.1 客户端消息请求格式 41 3.12.2 服务器端操作成功的返回消息格式 41 3.12.3 服务器端操作失败的返回消息格式 42 3.13 Detach方式PKCS7签名 42 3.13.1 客户端消息请求格式 42 3.13.2 服务器端操作成功的返回消息格式 43 3.13.3 服务器端操作失败的返回消息格式 43 3.14 Detach方式PKCS7签名验证 44 3.14.1 客户端消息请求格式 44 3.14.2 服务器端操作成功的返回消息格式 45 3.14.3 服务器端操作失败的返回消息格式 45 接口说明 注意：输出缓冲区的空间请在接口外部分配，请预留足够的存储空间，建议预留64K字节。另外输入的原文数据长度有限制，不能大于40K字节大小。 注意：以下接口输入和输出的原文都不是B64编码，接口内部会自动转换为B64编码，以便于传送。 客户端初始化 函数：int InitialVerif