电子口岸安全组件使用手册第一章控件使用说明
合集下载
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
返回值说明
0
取证书号成功
-1
卡初始化错
-2
取证书号失败
3.1.3.
函数原型
UINT Sign(BYTE *src, UINT srcLen, BYTE *sign, UINT* signLen, const char * pwd)
使用前提
extern "C" _declspec(dllimport) UINT Sign(BYTE *src, UINT srcLen, BYTE *sign, UINT* signLen, const char * pwd)
功能简介
取卡号，卡号至少分配100字节
参数说明
【out】szCardID
卡号，以\0结束
【in，out】nCardIDLen
卡号长度（该参数输入时不能等于0，必须是szCardID实际开辟的空间大小）
返回值说明
0
取卡号成功
-1
卡初始化错
-2
取卡号失败
3.1.2.
函数原型
UINT GetCertNo(BYTE* szCertNo, UINT* nCertNoLen)
电子口岸安全组件使用手册
第一章
本控件以dll的方式提供，调用时需链接
第二章
请注意以下事项：
（1）[in，out]类型的参数既为输入参数也为输出参数，在使用时必须给定参数的初始值，空间会根据该值判断调用者开辟的空间是否够大
（2）字符统一采用BYTE类型，即unsigned char，长度为UINT，即unsigned int，输出的字节流建议根据长度来取
使用前提
extern "C" _declspec(dllimport)UINT GetCertNo(BYTE* szCertNo, UINT* nCertNoLen)
功能简介
取证书号，证书号至少分配100字节
参数说明
【out】szCertNo
证书号，以\0结束
【in，out】nCertNoLen
证书号长度（该参数输入时不能等于0，必须是szCertNo实际开辟的空间大小）
（3）指针与缓冲区由外部调用程序做初始化
3.1.
3.1.1.
函数原型
UINT GetCardID(BYTE* szCardID,UINT* nCardIDLen)
使用前提
extern "C" _declspec(dllimport)UINT GetCardID(BYTE* szCardID, UINT* nCardIDLen)
功能简介
用加密设备传入报文进行加签
参数说明
【in】src
待签名的原始数据
【in】srcLen
待签名的原始数据的长度
【out】sign
签名数据，至少分配128字节
【in，out】signLen
gnData实际分配的空间大小
【in】pwd
进行加签的卡密码
返回值说明
0
签名成功
-1
卡初始化错
-2
卡口令不正确
-3
签名失败
-4
PEM编码失败
0
取证书号成功
-1
卡初始化错
-2
取证书号失败
3.1.3.
函数原型
UINT Sign(BYTE *src, UINT srcLen, BYTE *sign, UINT* signLen, const char * pwd)
使用前提
extern "C" _declspec(dllimport) UINT Sign(BYTE *src, UINT srcLen, BYTE *sign, UINT* signLen, const char * pwd)
功能简介
取卡号，卡号至少分配100字节
参数说明
【out】szCardID
卡号，以\0结束
【in，out】nCardIDLen
卡号长度（该参数输入时不能等于0，必须是szCardID实际开辟的空间大小）
返回值说明
0
取卡号成功
-1
卡初始化错
-2
取卡号失败
3.1.2.
函数原型
UINT GetCertNo(BYTE* szCertNo, UINT* nCertNoLen)
电子口岸安全组件使用手册
第一章
本控件以dll的方式提供，调用时需链接
第二章
请注意以下事项：
（1）[in，out]类型的参数既为输入参数也为输出参数，在使用时必须给定参数的初始值，空间会根据该值判断调用者开辟的空间是否够大
（2）字符统一采用BYTE类型，即unsigned char，长度为UINT，即unsigned int，输出的字节流建议根据长度来取
使用前提
extern "C" _declspec(dllimport)UINT GetCertNo(BYTE* szCertNo, UINT* nCertNoLen)
功能简介
取证书号，证书号至少分配100字节
参数说明
【out】szCertNo
证书号，以\0结束
【in，out】nCertNoLen
证书号长度（该参数输入时不能等于0，必须是szCertNo实际开辟的空间大小）
（3）指针与缓冲区由外部调用程序做初始化
3.1.
3.1.1.
函数原型
UINT GetCardID(BYTE* szCardID,UINT* nCardIDLen)
使用前提
extern "C" _declspec(dllimport)UINT GetCardID(BYTE* szCardID, UINT* nCardIDLen)
功能简介
用加密设备传入报文进行加签
参数说明
【in】src
待签名的原始数据
【in】srcLen
待签名的原始数据的长度
【out】sign
签名数据，至少分配128字节
【in，out】signLen
gnData实际分配的空间大小
【in】pwd
进行加签的卡密码
返回值说明
0
签名成功
-1
卡初始化错
-2
卡口令不正确
-3
签名失败
-4
PEM编码失败