智能密码钥匙密码应用接口规范.docx

ics 35040l 80备案号：383142013 bm中华人民 共禾口 国密码行业标准gmt 00162012智能密码钥匙密码应用接口规范smart token cryptography application interface specification20121 122发布 2012-1122实施国家密码管理局发布gmt 0016-2012目次前言1范围 2规范性引用文件 一3术语和定义 -4缩略语 - 一 工，：5结构模型 -一51层次关系 - ：052设备的应用结构 一 06数据类型定义061算法标识 062基本数据类型 - - - 063常量定义 - - 464复合数据类型 - 07接口函数- - n71设备管理 72访问控制-73应用管理- 一74文件管理75容器管理 -76密码服务 - - 8设备的安全要求 m牡趵站81设备使用阶段 82权限管理 83密钥安全要求 84设备抗攻击要求 拍弱拍拍附录a(规范性附录)错误代码定义和说明 盯gmt 00162012前言本标准按照obt 112009给出的规则进行编写。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由国家密码管理局提出并归日。本标准的附录a为规范性附录。 本标准起草单位：北京海泰方圆科技有限公司、北京握奇智能科技有限公司、北京大明五洲科技有限公司、恒宝股份有限公司、深圳市明华澳汉科技股份有限公司、武汉天喻信息产业股份有限公司、北京 飞天诚信科技有限公司、华翔腾数码科技有限公司。本标准起草人：刘平、郭宝安、石玉平、柳增寿、胡俊义、管延军、项莉、雷继业、胡鹏、赵再兴、段晓毅、 刘玉峰、刘伟丰、陈吉、何永福、李高锋、黄东杰、壬建承、汪雪林、赵李明。本标准凡涉及密码算法相关内容，按照国家有关法规实施。gmt 00162012智能密码钥匙密码应用接口规范1范围 本标准规定了基于pki密码体制的智能密码钥匙密码应用接口，描述了密码应用接口的函数、数据类型、参数的定义和设备的安全要求。 本标准适用于智能密码钥匙产品的研制、使用和检测。2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。gmt 0006密码应用标识规范 gmt 0009 sm2密码算法使用规范3术语和定义下列术语和定义适用于本文件。31应用application包括容器、设备认证密钥和文件的一种结构，具备独立的权限管理。3 2容器container密码设备中用于保存密钥所划分的唯一性存储空问。33设备device本标准中将智能密码钥匙统称为设备。34设备认证device authentication智能密码钥匙对应用程序的认证。35设备认证密钥device authentication key用于设备认证的密钥。3 6设备标签label设备的别名，可以由用户进行设定并存储于设备内部。3 7消息鉴别码message authentication code；mac消息鉴别算法的输出。gmt 0016201238管理员pin administrator pin管理员的口令，为ascii字符串。39用户pin usefpin用户的口令，为ascii字符串。4缩略语 下列缩略语适用于本规范：api应用编程接口(applicatlon programming interface)pki公钥基础设施(public key infrastructure)pkcs#1公钥密码使用标准系列规范中的第1部分，定义rsa公开密钥算法加密和签名机制(the public-key cryptography standard part 1)pkcs#5公钥密码使用标准系列规范中的第5部分，描述一种利用从口令派生出来的安全密 钥加密字符串的方法(the public-key cryptography standard part 5)pin个人身份识别码(personal mentification number) mac消息鉴别码(message authentication code)5结构模型51层次关系 智能密码钥匙密码应用接口位于智能密码钥匙应用程序与设备之间，如图1所示。智能密码钥匙应用程序 u 智能密码钥匙密码应用接口 u智能密码钥韪密码应用接h羲据格式u智能密码钥匙设罄驱动uuu一图1 接口在应用层次关系中的位置2gmt 0016201252设备的应用结构 一个设备中存在设备认证密钥和多个应用，应用之间相互独立。设备的逻辑结构如图2所示。设备认证密钼lljl应用1应用2 应用”图2设备逻辑结构 应用由管理员pin、用户pin、文件和容器组成，可以存在多个文件和多个容器。每个应用维护各自的与管理员pin和用户pin相关的权限状态。 一个应用的逻辑结构如图3所示。管理员pini用户pin f-司证书i卜硎证书|f1蕊丽一汀百磊藏一jr_=一ir荟磊丽j2仟1 。文件2劂踯i劂黜眷翻文件m 匿堕卿压匿豳三曩受霸图3应用逻辑结构图 容器中存放加密密钥对、签名密钥对和会话密钥。其中加密密钥对用于保护会话密钥，签名密钥对用于数字签名和验证，会话密钥用于数据加解密和mac运算。容器中也可以存放与加密密钥对对应 的加密数字证书和与签名密钥对对应的签名数字证书。其中，签名密钥对由内部产生，加密密钥对由外 部产生并安全导人，会话密钥可由内部产生或者由外部产生并安全导人。6数据类型定义61算法标识 本规范中使用的算法其标识定义见gmt 0006。62基本数据类型本规范中的字节数组均为高位字节在前(bigendian)方式存储和交换。基本数据类型定义如表1 所示。gmt 00162012表1基本数据类型类型名称 描述定义int8有符号8位整数 intl6有符号16位整数 int3z有符号32位整数 uint8无符号8位整数 uintl6无符号16位整数 uint32无符号32位整数b00l布尔类型，取值为true或falsebyte字节类型，无符号8位整数 typedef uint8 byte char字符类型，无符号8位整数 typedef uint8 char short短整数，有符号16位 typedef intl6 short ushort无符号16位整数 typedef uintl6 ushort long长整数，有符号32位整数 typedef int32 long ulong 长整数，无符号32位整数 typedef uint32 ulong uint 无符号32位整数typedef uint32 uint word 字类型，无符号16位整数 typedef uintlfi word dword 双字类型，无符号32位整敷 typedef uint32 dwordflags标志类型，无符号32位整数typedef uint32 flags8位字符串指针，按照utf8格式存lpstrtypedef char*lpstr储及交换handle句柄，指向任意数据对象的起始地址 typedef void*handle devhandle 设备旬柄 typedef handle devhandle happlication应用旬柄 typedef handle happlicatlon hcontainer容器句柄 typedef handle hcontainer63常量定义 数据常量标识定义了在规范中用到的常量的取值。数据常量标识的定义如表2所示。表2常量定义常量名 取值 描述true0x00000001布尔值为真false 0x0000000g布尔值为假devapistdcallstdcall函数调用方式4gmt 00162012 表2(续)gtlt-名取值描述 admintype 0 管理员pin类型 usertype1用户pin类型64复合数据类型641版本a)类型定义typedef struct structversionbyte maior；byte minor；)version；b)数据项描述见表3。表3版本定义数据项 类型意义备注mai。rbyte主版本号 主版本号和次版本号以“”分隔，例如version 10，主版本号为1，1mibyte次版本号 次版本号为0；version 210，主版本号为2，欢版本号为106 42设备信息a)类型定义typedef struet struct devinfofversionversion；charmanufacturer64；charissuerl 64|；charlabel32：charserialnumber32；version hwversion： version firmwareversion； ulongalgsymcap； ulong algasymcap；ulongaighashcsp ulongdevauthalgld； ulongtotalspace； ulongfreespace；ulongmaxeccbuffersizeulongmaxbutfersize；bytereserved64；)devinfo，*pdevinfo；5gmt 00162012 b)数据项描述见表4。表4设备信息描述数据项 类型意义 备注versionversion版本号 数据结构版本号，本结构的版本号为10madufaeturer char数组 设备厂商信息 以0为结束符的ascii字符串 igsuer char数组 发行厂商信息 以o为结束符的ascii字符串 label char数组 设备标签 以o为结束符的ascii字符串 serialnumber char数组 序列号 以o，为结束符的ascii字符串hwverslonversl0n设备硬件版本fitinwareversionversion 设备本身固件版本 algsymcapulong分组密码算法标识 algasymcap ulong 非对称密码算法标识 alghashcap ulong 密码杂凑算法标识设备认证使用的分组密码算法devauthalgldulong标识to忸lspaceulong设备总空问太小 freespaceulong 用户可用空间大小 maxeccbuffersizeulong 能够处理的ecc加密数据大小能够处理的分组运算和杂凑运算maxbuffersize的数据大小resdbyte保留扩展643 rsa公钥数据结构a)类型定义typedestruct struct rsapublickeyblobfulongalgld) ulongbitlen：bytemodulusmax rsa modulus len；bytepublicexponentmax rsa exponent lenrsapublickeyblob，*prsapublickeyblob； max rsamoduluslen为算法模数的最大长度； max rsaexponentlen为算法指数的最大长度。b)数据项描述见表5。表5 lisa公钥数据结构数据项 类型意义备注aigidulong算法标识号i bitlenulong模数的实际位长度 必须是8的倍数6gmt 00162012 表5(续)数据项 类型 意义备注 实际长度为bitlen8字节modulus byte数组 模数np*q #define max rsa modulus len 256#define max rsa exponent len 4publicexponent byte数组公开密钥e一般为00010001644 rsa私钥数据结构a)类型定义typedef struct struct rsaprivatekeyblobfulong aigld；ulong bitlen；byte modulusmax rsa modulus len：byte publicexponentmax rsa exponent len： byte privateexponentmax rsa modulus len： byte primelmax rsa modulus len2：byte prime2fmax rsa modulus len2：byte primelexponentmax rsa modulus len2 byte prime2exponentmax_rsa modulus len2 byte coefficientl max rsa modulus len2：rsaprivatekeyblob，*prsaprivatekeyblob； maxrsa moduluslen为rsa算法模数的最大长度；b)数据项描述见表6。表6 rsa私钥数据结构数据项 类型 意义备注algidulong算法标识号b“lenulong模数的实际位长度必须是8的倍数modulusbyte数组 模数一p+q 实际长度为bitlen8字节 publicexponent byte数组 公开密钥e一般为0001000l privateexponent byte数组私有密钥d 实际长度为bitlen8字节 primel byte数组素数p 实际长度为bitlen16字节 prime2 byte数组素数q 实际长度为bitlen16字节 primelexponent byte数组d mod(p一1)的值实际长度为bitlen16字节 prime2exponent byte数组dmod(q1)的值 实际长度为bitlen16字节 coefficientbyte数组 q模p的乘法逆元实际长度为bitlen16字节645 ecc公钥数据结构a)类型定义7gmt 00162012typedef struct structeccpublickeyblob(ulongbitlen：bytexcoordinateeccmaxxcoordinatebits-len8；byteycoordinateecc max ycoordinate bits len8：)eccpublickeyblob，*peccpublickeyblob； eccmaxlxcoordinatelen为ecc算法x坐标的最大长度； eccmaxycoordinatelen为ecc算法y坐标的最大长度。b)数据项描述见表7。表7 ecc公钥数据结构数据项 类型 意义备注bitlenulong模数的实际位长度必须是8的倍数有限域上的整数xcoordinate byte数组曲线上点的x坐标世defineecc-maxxcoordinate bits_len 512有限域上的整数ycoordinate byte数组曲线上点的y坐标封defineectmaxycoordinatebitslen 512646ecc私钥数据结构a)类型定义typedef struct structeccprivatekeyblobulongbitlen；byteprivatekeyecc_maxmodulus bits-len8；eccprivatekeyblob，*peccprivatekeyblob oecc-maxmodulus_bit殳len为ecc算法模数的最大长度。b)数据项描述见表8。表8 ecc私钥数据结构数据项 类型意义备注bitlenulong模数的实际位长度必须是8的倍数有限域上的整数privatekey byte数组私有密钥 生defineecc-makmodulus_bitslen 512647ecc密文数据结构a)类型定义typedef struct structecccipherblob(bytexcoordinate-ecc_max_xcoordinatebitslen88gmt 0016-2012byteycoordinateeccmax二xc00rdinate-bitslen8byte hash32： ulongcipherlen： bytecipheri；)ecccipherblob，*pecccipherblob；b)数据项描述见表9。表9 ecc密文数据结构数据项 类型意义备注xcoordinate byte数组 与y组成椭圆曲线上的点(x，y) ycoordinate byte数组 与x组成椭圆曲线上的点(x，y) hash byte数组 明文的杂凑值cioherlen ulong 密文数据长度cioher byte数组 密史数据 实际长度为cipherlen648 ecc签名数据结构a)类型定义typedef struot struet eccsignatureblob byteecc max xc00rdinate bits len8； byte secc max xcoord【nate bits len8：)eccsignatureblob，*peccsignatureblobj eccmaxmodulusbitslen为ecc算法模数的最大长度 b)数据项描述见表10。表10 ecc签名数据结构i数据项 类型意义备注|rbyte数组 签名结果的r部分s byte数组 签名结果的s部分649分组密码参数a)类型定义typedef struct structblockcipherparam(byteivmax iv lentulongivlen； ulongpaddingtype；ulongfeedbitlen：)blockcipherparam*pblockcipherparamb)数据项描述见表11。9gmt 00162012表11分组密码参数数据项 类型意义备注初始向量，maxivlen为初始化向量的最大iv byte数组长度#define max-iv_len 32i、，lenulong初始向量实际长度(按字节计算) 填充方式，0表示不填充，1表示按照pkcs#5方paddingtypeulong式进行填充feedbitlenulong反馈值的位长度(按位计算)只针对ofb、cfb模式6410 ecc加密密钥对保护结构a)类型定义typedef struct skf envelopedkeyblobulong versiom 当前版本为1ulong ulsymmalgid；对称算法标识，限定ecb模式ulong ulbits； 加密密钥对的密钥位长度 byte cbencryptedprikeyl-64； 加密密钥对私钥的密文 eccpublickeyblob pubkey； 加密密钥对的公钥 ecccipherblob ecccipherblob；用保护公钥加密的对称密钥密文)envelopedkeyblob，*penvelopedkeyblob；b)数据项描述见表12。表12加密密钥对保护结构参数数据项 类型 意义各注versionulong版本号，本版本为1u1symmalgidulong 对称算法标识 必须为ecb模式ulbits ulong加密密钥对的密钥位长 对称算法加密的加密私钥，加密私钥的原文为ec其有效长度为原文的cbencryptedprivkey byte数组cprivatekeyblob结(ulbits+7)8构中的privatekeypubkeyeccpublickeyblob 加密密钥对的公钥 用保护公钥加密过的对称ecccipherblobecccipherblob密钥密文6411文件属性a)类型定义typedef struct structfileattributecharfilename-32；10gmt 00162012ulongfilesize： ulongreadrights；ulongwriterights；)fileattribute，*pfileattribute；b)数据项描述见表13。袭13文件属性数据项 类型意义备注filename char数组文件名以o结束的ascii字符申，最大长度为32filesizeulong文件大小 创建文件时定义的文件大小 readrightsulong 读取权限 读取文件需要的权限 writerights ulong写入权限 写人文件需要的权限6412权限类型 权限类型的定义见表14。表14权限类型权限类型值说明secure neveraccount不允许 secure admaccount0x0000000l管理员权限 secure-use匙account0x00000010 用户权限secure-anyoneaccount0x000000ff 任何人6413设备状态 设备状态的定义见表15。表15设备状态设备状态值说明 dev absent state0xg0000000设备不存在 de虻presentstate0x00000001 设备存在 de虻unknow stateo如0000002 设备状态未知7接口函数71设备管理711概述 设备管理主要完成设备的插拔事件处理、枚举设备、连接设备、断开连接、获取设备状态、设置设备11cmt 00162012标签、获取设备信息、锁定设备、解锁设备和设备命令传输等操作。设备管理系列函数如表16所示。表16设备管理系列函数函数名称功能 skfwaitfordevevem 等待设备插拔事件 skfcanceiwaitfordevevent 取消等待设备插拔事件skf erumdev 枚举设备 skf_connectdev 连接设备 skf-discormeetdev 断开连接skfgetd)evstate 获取设备状态 sfif setlabel 设置设备标签 skv getdevlnfo 获取设备信息 skf lockdev 镇定设备skf urnlockdev 解锁设备skf tiransmit 设备命令传输712等待设备插拔事件函数原型 ulong deu)i skf w乱tfordevevent(lpstr szdevname，ulong+pu|devnamelen。 ulong o pulevent)功能描述 该函数等待设备插入或者拔除事件。szdevname返回发生事件的设备名称。 参数 szdevnameeout发生事件的设备名称。puldevnameleneinouti输入输出参数，当输入时表示缓冲区长度，输出时 表示设备名称的有效长度，长度包含字符串结束符。puieventeout事件类型。1表示插入，2表示拔出。 返回值 sar 0k：成功。其他：错误码。 备注本函数为阻塞函数。713取消等待设备插拔事件函数原型 ulong devapi skf_cancelwaitfordevevent() 功能描述 该函数取消等待设备插入或者拔除事件。参数返回值 sar ok：成功。 其他：错误码。备注 使本进程正在执行的skfwaitfordevevent函数立即返回。714枚举设备函数原型 ulong devapi skfenumdev(bool bpresent，lpstr sznamelist，ulong*pulsize)1 2cmt 00162012 功能描述 获得当前系统中的设备列表。参数 bpresent un为true表示取当前设备状态为存在的设备列表。为 false表示取当前驱动支持的设备列表。sznamelistout设备名称列表。如果该参数为null，将由pulsize返 回所需要的内存空间大小。每个设备的名称以单个0结束， 以双0表示列表的结束。pulsize in，out输入时表示设备名称列表的缓冲区长度，输出时表 示sznamelist所占用的空间大小。返回值 sar_ok： 成功。 其他：错误码。715连接设备函数原型 ulong devapi skfconnectdev(lpstr szname，devhandle+phdev)功能描述 通过设备名称连接设备，返回设备的句柄。 参数 znamein设备名称。phdev out返回设备操作句柄。 返回值 sar_ok：成功。其他：错误码。716断开连接函数原型 ulong devapi skf_disconnectdev(devhandle hdev)功能描述 断开一个已经连接的设备，并释放句柄。 参数hdevin连接设备时返回的设备句柄。 返回值 sarok：成功。其他：错误码。备注 如果该设备已被锁定，函数应首先解锁该设备。断开连接操作并不影响设备的权限状态。717获取设备状态函数原型 ulong devapi skfgetdevstate(lpstr szdevnameulongpuldevstate)功能描述 获取设备是否存在的状态。参数 szdevnamein设备名称。puldevstate outj返回设备状态。 返回值 sar-ok：成功。其他：错误码。718设置设备标签函数原型 ulong devapi skfsetlabel(devhandle hdev，lpstr szlabel)功能描述 设置设备标签。参数 hdev in连接设备时返回的设备句柄。szlabel in设备标签字符串。该字符串应小于32字节。 返回值 sarok：成功。其他：错误码。13gmt 00162012719获取设备信息函数原型 ulong devapi skf getdevinfo(devhandle hdev，devinfo+pdevlnfo)功能描述 获取设备的一些特征信息，包括设备标签、厂商信息、支持的算法等。 参数 hdev in连接设备时返回的设备句柄。pdevinfo out返回设备信息。 返回值 sarok：成功。其他：错误码。7110锁定设备函数原型ulong devapi skflockdev(devhandle hdev，ulong ultimeout)功能描述 获得设备的独占使用权。参数hdevin连接设备时返回的设备句柄。ultimeout i-in超时时间，单位为毫秒。如果为0xffffffff表示无限等待。 返回值 sarok：成功。其他：错误码。7111解锁设备函数原型 ulong devapi skfunlockdev(devhandle hdev)功能描述 释放对设备的独占使用权。参数hdevin连接设备时返回的设备句柄。 返回值 sarok：成功。其他：错误码。7112设备命令传输函数原型 ui，ong devapi skf_transmit(devhandle hdbv，bytepbcommand，ulong ulcommandlen，byte。pbdata，ulongpuldatalen) 功能描述 将命令直接发送给设备，并返回结果。 参数hdevein设备句柄。pbcommandin设备命令。uleommandlenin命令长度。pbdata out返回结果数据。puldatalenin，out输入时表示结果数据缓冲区长度，输出时表示结果数据实际 长度。返回值 sarok：成功。 其他：错误码。备注本函数仅用于设备检测。72访问控制721概述 访问控制主要完成设备认证、pin码管理和安全状态管理等操作。访问控制系列函数如表17所示。14gmt 00162012 表17访问控制系列函数函数名称 功能skf_changedevauthkey修改设备认证密钥 skf devauth设备认证 skf_changepin 修改pin skf_getpininfo 获得pin码信息 skf verifvpin 校验pinskfunbloekpin解锁pinskf_c1earsecuestate 清除应用安全状态722修改设备认证密钥函数原型 ulong devapi skf_changedevauthkey(devhandieldev，byte+pbkeyvallieulong ulkeylen)功能描述 更改设备认证密钥。参数 hdev in连接时返回的设备旬柄pbkeyvaluein密钥值ulkeylenin3密钥长度 返回值 sarok：成功。其他：错误码。备注 权限要求：设备认证成功后才能使用。723设备认证函数原型 ulong devapi skf devauth(devhandle hi)ev，byte+pbauthdata，ulong u1 len)功能描述 设备认证是设备对应用程序的认证。认证过程见823。 参数 hdev in连接时返回的设备句柄。pbauthmatain认证数据。ullenin认证数据的长度。 返回值 sailok：成功。其他：错误码。724修改pin函数原型 ulong devapi skf_changepin(happlication happlicafion，ulong ulplntype， lpstr sz0idpin。lpstr sznewpinulongpulretrycount)功能描述 调用该函数可以修改administrator pin和user pin的值。如果原pin码错误导致验证失败，该函数会返回相应pin码的剩余重试次数，当剩余次 数为0时，表示pin已经被锁死。参数 happlication in应用句柄。ulpintype inpin类型，可为admintype或usertype。szoldpin in原pin值。1 5gmt 00162012sznewpinin新pin值。pulretrycountout出错后重试次数 返回值 sap,_ok：成功。其他：错误码。725获取pin信息函数原型 ulong devapi skf getpninfo(happication happldcation，ulong ulpintype，ulong。pulmaxretrycountulongpulremainretrycount。bool。pbdefaultpin)功能描述 获取fin码信息，包括最大重试次数、当前剩余重试次数，以及当前pin码是否为出厂默 认pin码。参数 happlication in应用句柄。ulpintypeinpin类型。pulmaxretrycount out最大重试次数。pulremainretrycountout当前剩余重试次数，当为0时表示已锁死。pbdefauhpioout是否为出厂默认pin码。 返回值 sarok：成功。其他：错误码。726校验pin函数原型 ulong devapi skf verifypin(happlication happlication，ulong ulpintype， lpstr szpequlongpulretrycount)功能描述 校验pin码。校验成功后，会获得相应的权限，如果pin码错误，会返回pin码的重试 次数，当重试次数为0时表示pin码已经锁死。参数happlicationin应用句柄。 ulpintypein-pin类型。 szpin inpin值。pulretrycountout出错后返回的重试次数。返回值 sar_ok： 成功。 其他：错误码。727解锁pin函数原型 ulong devapi skfunblockpin(happlication happlicafioo，liar szadminpin， lpstr sznewuserpinulong”pulretrycount)功能描述 当用户的pin码锁死后，通过调用该函数来解锁用户pin码。 解锁后，用户pin码被设置成新值，用户pin码的重试次数也恢复到原值。参数happlicationin应用句柄。 szadminpinin管理员pin码。 sznewuserpinin新的用户pin码。pulretrycountout管理员pin码错误时，返回剩余重试次数。 返回值 sarok：成功。其他：错误码。备注验证完管理员pin才能够解锁用户pin码，如果输入的administrator pin不正确或者 已经锁死，会调用失败，并返回administrator pin的重试次数。】6gmt 00162012728清除应用安全状态函数原型 ulong devapi skf_clearsecurestate(happlication happlication)功能描述 清除应用当前的安全状态。 参数happlicationein应用句柄。 返回值 sar ok：成功。其他：错误码。73应用管理731概述 应用管理主要完成应用的创建、枚举、删除、打开、关闭等操作。应用管理系列函数如表18所示。表18应用管理系列函数函数名称 功能 skf_createapplication创建应用skfenumapplication 枚举应用 skf deleteapplication 删除应用 skffopenapplication 打开应用skf_closeapplication 关闭应用732创建应用函数原型 ulong devapi skfcreateapplication(devhandle hdev，lpstr szappname， lpstr szadminpin，dword dwadminpinretrycount，lpstr szuserpin，dword dwuserpinretrycmunt，dword dwcreatefilerights，happlication。phapplication)功能描述 创建一个应用。参数 hdev in连接设备时返回的设备句柄。szappnameein4应用名称。 szadminpinein管理员pin。 dwadminpinretrycountin管理员pin最大重试次数。 szuserpin in用户pin。 dwuserpinretrycountin用户pin最大重试次数。dwcreatefilerightsin在该应用下创建文件和容器的权限，参见6412权限类 型。为各种权限的或值。phapplicationout应用的句柄。 返回值 sarok：成功。其他：错误码。 备注 权限要求：需要设备权限。733枚举应用函数原型 ulong devapi skfenumapplication(devhandle hdev，lpstr szappnameulongpulsize)1 7gmt 08162012功能描述 枚举设备中存在的所有应用。参数 hdev 1n连接设备时返回的设备句柄。szappnameout返回应用名称列表，如果该参数为空，将由pulsize返回所需要 的内存空间大小。每个应用的名称以