SDK OCX接口开发文档V1.0.pdf

SDK COM 接口方法定义 1 GetFingerPrintData 函数原型(Archetype) BSTR GetFingerPrintData(void); 函数功能(Description) 获取用户的指纹操作信息。用户进行指纹注册、修改、验证等录入指纹操作后，指 纹数据包通过此方法返回。 函数变量(Parameter) NULL 返回值(Return Value) 如果函数GetFingerPrintData 出错，则返回值为字符串格式的错误码。 -301 ：控件异常。 -302 ：持久化参数CtrlType 设置有误，为了方便，设置错误的时候，直接出比对控 件。 -303 ：持久化参数FingerInfo 设置有误。 -304 ：持久化参数token 设置有误。 -311 ：设备不存在。 -321 ：指纹特征还没有生成，就想取特征。 -322 ：指纹模板还没有生成，就想取模板值。 如果函数成功，则返回的数据就是用户操作后的指纹信息数据（注册指纹时，返回 的是模板数据，比对时，则返回指纹特征数据）。 备注(Remarks) 获取用户操作后的指纹信息数据后，把本数据传递到服务器端，根据服务器端操作 后的结果，就可以提示用户操作是否成功。此方法的返回值格式会受到 SetFPVersion、 SetIBVersion、SetParameter 和SetHexFlg 设置参数的影响。这四个方法都设置参数为0 时或者都不调用这四个方法。则返回指纹信息数据为标准版。 2 SetOperateParam 函数原型(Archetype) SHORT SetOperateParam(LPCTSTR operateInfo) 函数功能(Description) 设置注册手指状态，并使设置马上生效。 函数变量(Parameter) LPCTSTR operateInfo ：可将已注册手指作为参数传入，代替FingerInfo 属性设置。 如十个由0 和1 组成的字符串“1110011111”代表从左到右十个手指，0 表示还没有注 册，1 表示已经注册。 返回值(Return Value) 保留返回值，不需要作处理 备注(Remarks) 此方法功能与新版本的 SetFingerHasEnroll 一样，但这里建议使用 SetFingerHasEnroll。调用此方法后，指纹控件回到初始状态 3 InitInstance 函数原型(Archetype) SHORT InitInstance(LPCTSTR timeStamp) 函数功能(Description) 初始化指纹控件，需要传入长度固定为32byte 的timeStamp 函数变量(Parameter) BSTR timeStamp：长度固定为32byte 的时间戳（从服务器端获取），保留参数，只要传够32 个 字符就可以了 返回值(Return Value) 保留返回值，不需要作处理 备注(Remarks) 在进行指纹重新操作之前或开始操作的时候，可以调用本接口，对控件进行重新初始 化。即提示用户再次刷取指纹。 4 SetAgentInfo 函数原型(Archetype) SHORT SetAgentInfo(LPCTSTR Value) 函数功能(Description) 把初始化指纹控件、策略、时间戳和指位等数据（通过webservice 接口获取数据 报文）设置集成到一个方法里完成。 函数变量(Parameter) LPCTSTR Value：初始化指纹控件、策略、时间戳和指位等以十六进制可见字符 格式传入的数据。 返回值(Return Value) 0 为成功，其他为错误码。 备注(