OUR-MIFARE.dll动态库使用说明.doc

OUR_MIFARE.dll动态库使用说明

———————————————————————————————— 作者：
———————————————————————————————— 日期：

2

个人收集整理 勿做商业用途
OUR_MIFARE.dll动态库使用说明
一、 动态库简介
动态库OUR_MIFARE。dll用VC6.0++开发，编译成Release实体，适用于WIN98、NT、2000、XP、2003环境。本文档下面的源代码例子是C++builder 的调用格式。
本动态库是本公司USB接口IC卡读写器的配套文件，必须和读写器一起使用。还必须将硬件底层驱动的动态库ICUSB.DLL放在与OUR_MIFARE.dll同一个目录下，否则不能使用。
OUR_MIFARE.dll在调用ICUSB.DLL时采用的是动态调用的方法，所以在软件运行中可以随时更换USB接口。
推荐使用动态调用的方法使用本动态库。
IC卡内部存储结构知识：
本读写器支持ISO14443 TYPE A标准的Mifare One系列卡.Mifare One卡的内部存储结构分为16个扇区，从第0区到第15区，每个扇区有独立的密码和权限控制字，可作为独立的电子钱包，每个扇区有4个块，序号为第0块、第1块、第2块、第3块，每块16个字节，第3块是卡的密码和权限控制字专用块，禁止在此存放数据。第0块、第1块、第2块可随意存放数据。但第0区的第0块已被固化了IC卡出厂信息，此块只能读出信息，不可更改。
每张卡都有一个全球统一的4个字节的序列号。许多公司销售的读卡器只有读取卡序列号的功能,也能用于一般的考勤系统。但这类读卡器跟本公司的读写器有着本质的不同，本公司的读写器不仅能读序列号，而且还有服务于IC卡所有用途的功能，比如选中卡、认证、读卡、写卡、改密码、休眠卡能功能.
二、易用函数
大部份软件、一卡通公司，只要使用以下二个函数完全可以达到软件需求，比如读出信息、读出金额、扣费等等。
轻松读卡：
函数名：piccreadex
功能
超强读卡，使用些函数可以一次性读整个区的第0块、第1块、第2块共3块的信息,并且返回卡序列号。
原始声明
unsigned char __stdcall piccreadex(unsigned char ctrlword,unsigned char *serial,unsigned char area，unsigned char keyA1B0，unsigned char ＊picckey,unsigned char *piccdata0_2）
输入
1、ctrlword读卡的控制字，ctrlword是一个字节，相当于八个位，每个位只有0和1两种状态：

推荐使用方法如下:
//先定义以下常量
＃define BLOCK0_EN 0x01
#define BLOCK1_EN 0x02
#define BLOCK2_EN 0x04
#define NEEDSERIAL 0x08
＃define EXTERNKEY 0x10
举例:
//以下控制字含义：读块0、块1、块2，仅读指定序列号的卡,需要每次指定密码
Ctrlword = BLOCK0_EN + BLOCK1_EN + BLOCK2_EN + NEEDSERIAL+ EXTERNKEY
//以下控制字含义：读块0、块2,可读任意卡，需要每次指定密码
Ctrlword = BLOCK0_EN + BLOCK2_EN + EXTERNKEY
//以下控制字含义：读块0、块2，可读任意卡，启用芯片内部密码
Ctrlword = BLOCK0_EN + BLOCK2_EN

2、serial只需指向一个至少已分配了4个char空间的可写数组 unsigned char *指针， serial的下标由0开始。如果在控制字中没有指定NEEDSERIAL ,则Serial数组的内容无需赋值，因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。
3、area是需要读出的区号，则0-15中的某个数。
4、keyA1B0为0时以B密码来认证，为非0时以A密码来认证。刚出厂的卡以A密码来认证.

5、＊picckey 指向存放卡密码的数组(6个char的密码数组)。

6、*piccdata0_2是指向下标个数大于48的字节数组，用于存放3个块的数据，其中下标0～15存放作为读出的块0的数据,下标16～31存放作为读出的块1的数据,下标32～47存放作为读出的块2的数据，
返回
返回unsigned char值,并将卡本块的数据传值到＊piccdata指向的数组中.
返
回
值
说
明
0
操作成功，读出的数据有效。
1
0~2块都没读出来,可能刷卡太块。但卡序列号已被读出来。
2
第0块已被读出,但1～2块读取失败。卡序列号已被读出来.
3
第0、1块已被读出,但2块读取失败。卡序列号已被读出来。
8
寻卡错误，根本就没有卡在感应区,*serial无效.
9
有多张卡在感应区，寻卡过程中防冲突失败，*serial无效.
10
该卡可能已被休眠,无法选中，但卡序列号已被读出，*serial数组中的数据有效。
11
密码装载失败。
12
密码认证失败。
21
本函数需要引用的动态库ICUSB.DLL不在当前目录下.
22
动态库或驱动程序异常，解决方法是退出程序，拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。dll到正确的位置。
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器.
27
USB传输不稳定导致传输的字符不全.不需理会这个错误，因为基本上是不会出现这个错误的.
28
USB传输不稳定导致CRC校验错.不需理会这个错误，因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释
请要本公司网站下载各种开发工具的例子源代码，本函数的声明和输入参数格式可以直接套用，谢谢使用

轻松写卡：
函数名：Piccwriteex
功能
超强写卡，使用些函数可以一次性写整个区的第0块、第1块、第2块信息。
原始声明
unsigned char __stdcall piccwriteex(unsigned char ctrlword，unsigned char ＊serial,unsigned char area， unsigned char keyA1B0,unsigned char *picckey，unsigned char ＊piccdata0_2）
输入
1、ctrlword读卡的控制字,ctrlword是一个字节，相当于八个位，每个位只有0和1两种状态：

推荐使用方法如下：
//先定义以下常量
＃define BLOCK0_EN 0x01
#define BLOCK1_EN 0x02
＃define BLOCK2_EN 0x04
#define NEEDSERIAL 0x08
#define EXTERNKEY 0x10
#define NEEDHALT 0x20
举例：
//以下控制字含义:读块0、块1、块2，仅写指定序列号的卡，需要每次指定密码，写成功后休眠卡
Ctrlword = BLOCK0_EN + BLOCK1_EN + BLOCK2_EN + NEEDSERIAL+ EXTERNKEY + NEEDHALT
//以下控制字含义：写块0、块2，可写任意卡,需要每次指定密码， 写成功后休眠卡
Ctrlword = BLOCK0_EN + BLOCK2_EN + EXTERNKEY + NEEDHALT
//以下控制字含义：写块0、块2，可写任意卡，启用芯片内部密码，写成功后休眠卡
Ctrlword = BLOCK0_EN + BLOCK2_EN + NEEDHALT

2、serial只需指向一个至少已分配了4个char空间的可写数组 unsigned char *指针， serial的下标由0开始.如果在控制字中没有指定NEEDSERIAL ，则Serial数组的内容无需赋值，因为此数组仅用于返回值。如果指定了NEEDSERIAL，则必须为该数组的内容赋值。

3、area是需要准备写的区号,则0-15中的某个数.

4、keyA1B0为0时以B密码来认证,为非0时以A密码来认证。刚出厂的卡以A密码来认证。

5、*picckey 指向存放卡密码的数组(6个char的密码数组）。

6、＊piccdata0_2是指向下标个数大于48的字节数组,用于存放3个块的数据,其中下标0～15存放作为准备写的块0的数据，下标16~31存放作为准备写的块1的数据，下标32～47存放作为准备写的块2的数据，
返回
返回unsigned char值，并将卡本块的数据传值到＊piccdata指向的数组中。
返
回
值
说
明
0
操作成功，写卡数据有效。
1
0～2块都没写进去,可能刷卡太块。
2
第0块已写进去，但1~2块写失败.
3
第0、1块已被写进去，但2块读写失败。
8
寻卡错误,根本就没有卡在感应区,*serial无效。
9
有多张卡在感应区,寻卡过程中防冲突失败，*serial无效。
10
该卡可能已被休眠，无法选中，但卡序列号已被读出，＊serial数组中的数据有效。
11
密码装载失败。
12
密码认证失败
21
本函数需要引用的动态库ICUSB。DLL不在当前目录下。
22
动态库或驱动程序异常，解决方法是退出程序，拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试,或者重新拷贝动态库OUR_MIFARE.dll到正确的位置。
24
操作超时.可能是电脑中毒导致USB帧传递调度缓慢,或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。
27
USB传输不稳定导致传输的字符不全。不需理会这个错误，因为基本上是不会出现这个错误的。
28
USB传输不稳定导致CRC校验错。不需理会这个错误，因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释
请要本公司网站下载各种开发工具的例子源代码，本函数的声明和输入参数格式可以直接套用，谢谢使用

以上函数是在已知卡密码的情况下操作。如果需要更改卡密码可通过piccchangesinglekey函数，快速地更改卡密码，piccchangesinglekey详细介绍请查看下面第12页.

让读写器发出声音
函数名:pcdbeep
功能
让读写器发出声响。（暂不开放对指示灯的控制，如果有特殊要求请致电本公司）
原始声明
unsigned char __stdcall pcdbeep（unsigned long xms）
输入
xms为响声的时间长度，单位为2毫秒
返回
返回unsigned char值。
返
回
值
说
明
0
操作成功，。
21
本函数需要引用的动态库ICUSB。DLL不在当前目录下。
22
动态库或驱动程序异常，解决方法是退出程序，拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。dll到正确的位置.
24
操作超时.可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。
27
USB传输不稳定导致传输的字符不全。不需理会这个错误，因为基本上是不会出现这个错误的。
28
USB传输不稳定导致CRC校验错.不需理会这个错误，因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释
请要本公司网站下载各种开发工具的例子源代码，本函数的声明和输入参数格式可以直接套用，谢谢使用

三、 可作为软件加密狗,轻松实现自己软件的产权保护。
函数名：pcdgetdevicenumber
功能
返回本读写器独一无二的设备编号，此编号固化在芯片中，并通过加密的方式传输。根据此编号可在本公司网站查询是否真正为本公司的质保产品。因为可以返回全球唯一的设备编号，所以只需增加少量的算法，本读写器也可作软件加密狗用.
原始声明
unsigned char __stdcall pcdgetdevicenumber（unsigned char ＊devicenumber）
输入
devicenumber只需指向一个至少已分配了4个char空间的可写数组 unsigned char *指针， serial的下标由0开始。因为此数组仅用于返回设备编号。
返回
返回unsigned char值,并将寻到的卡的序列号传值到＊serial数组。
返
回
值
说
明
0
操作成功，＊ devicenumber数组中的数据有效.
12
读取设备编号失败。
9
有多张卡在感应区，寻卡过程中防冲突失败，*serial无效。
10
该卡可能已被休眠,无法选中，但卡序列号已被读出,＊serial数组中的数据有效。
21
本函数需要引用的动态库ICUSB。DLL不在当前目录下。
22
动态库或驱动程序异常，解决方法是退出程序，拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。dll到正确的位置。
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器.
28
USB传输不稳定导致CRC校验错。不需理会这个错误,因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释
请要本公司网站下载各种开发工具的例子源代码，本函数的声明和输入参数格式可以直接套用，谢谢使用

功能
四、 其他函数大全
函数名：piccrequest
功能
寻卡并返回该卡的序列号
原始声明
unsigned char __stdcall piccrequest(unsigned char *serial)
输入
形参＊serial只需指向一个至少已分配了4个char空间的可写数组 unsigned char *指针, serial的下标由0开始。Serial数组的内容无需赋值,因为此数组仅用于返回值。
返回
返回unsigned char值,并将寻到的卡的序列号传值到*serial数组。
返
回
值
说
明
0
操作成功，*serial数组中的数据有效。
8
寻卡错误,根本就没有卡在感应区,*serial无效.
9
有多张卡在感应区,寻卡过程中防冲突失败，*serial无效。
10
该卡可能已被休眠，无法选中，但卡序列号已被读出，*serial数组中的数据有效。
21
本函数需要引用的动态库ICUSB.DLL不在当前目录下。
22
动态库或驱动程序异常，解决方法是退出程序，拔出IC卡读写器,重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。dll到正确的位置。
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。
28
USB传输不稳定导致CRC校验错。不需理会这个错误，因为基本上是不会出现这个错误的.
其他
未知错误
例子及注释
/＊＊＊＊＊***＊****＊****＊{{piccrequest函数使用特例＊＊＊＊＊*＊********＊*＊*＊＊****＊＊*＊＊*＊＊/
//卡序列号缓冲
unsigned char myserial[4］；
unsigned char status;
//函数指针声明
unsigned char (__stdcall ＊piccrequest）（unsigned char *serial）；
//提示当前目录
AnsiString FileName=ExtractFilePath（Application->ExeName）;
//如果中没有"\"字符，就加进去
if(FileName。SubString（FileName。Length（),1) != ”\\")
｛
FileName += "\\";
}

//调用读卡函数,如果没有寻到卡返回1，拿卡太快返回2，没注册发卡机返回4,没有驱动程序返回3
FileName += ”OUR_MIFARE.dll";
if（！FileExists（FileName))
｛//如果文件不存在
ShowMessageb（"无法在应用程序的文件夹找到IC卡读写卡器动态库”);
return; //返回
}
HINSTANCE hDll;
//加载动态库
hDll=LoadLibrary（FileName。c_str(）);
//提取动态库
piccrequest = （unsigned char （__stdcall ＊piccrequest)(unsigned char *serial)）GetProcAddress（hDll,"piccread”）；
//调用函数
status = piccrequest(myserial);
//返回值处理
switch（status)
{
case 0：
//TO—DO相应的处理，请在以下加入代码
break；
case 1:
break;
//。..
｝
注:原始声明指动态库的VC源码内的声明。
函数名：piccrequestex
功能
寻卡并选中指定序列号的IC卡，必须指定序列号
原始声明
unsigned char __stdcall piccrequestex （unsigned char *serial）
输入
形参*serial只需指向一个至少已分配了4个char空间的数组 unsigned char *指针, serial的下标由0开始, serial数组的值为需要寻卡选卡的卡序列号。
返回
返回unsigned char值，并将寻到的卡的序列号传值到＊serial数组。
返
回
值
说
明
0
操作成功，＊serial数组中的数据有效。
8
寻卡错误，根本就没有卡在感应区，*serial无效。
9
有多张卡在感应区，寻卡过程中防冲突失败，*serial无效。
10
该卡可能已被休眠，无法选中，但卡序列号已被读出，*serial数组中的数据有效。
21
本函数需要引用的动态库ICUSB.DLL不在当前目录下。
22
动态库或驱动程序异常，解决方法是退出程序,拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE.dll到正确的位置.
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题,解决方法是重启电脑或重新拔插IC卡读写器。
28
USB传输不稳定导致CRC校验错.不需理会这个错误，因为基本上是不会出现这个错误的.
其他
未知错误
例子及注释
/＊＊*＊＊**＊＊*＊*＊＊＊*＊*＊{{piccrequestex函数使用特例*＊*＊*＊＊*＊＊****＊＊＊**＊＊*＊***＊＊*＊***/
//卡序列号缓冲
unsigned char myserial［4];
unsigned char status;
//函数指针声明
unsigned char (__stdcall ＊piccrequestex)（unsigned char ＊serial）;
//提示当前目录
AnsiString FileName=ExtractFilePath(Application->ExeName）；
//如果中没有”\”字符，就加进去
if（FileName.SubString(FileName.Length（),1) != "\\”）
｛
FileName += ”\\”；
}

//调用读卡函数，如果没有寻到卡返回1,拿卡太快返回2，没注册发卡机返回4，没有驱动程序返回3
FileName += ”OUR_MIFARE.dll"；
if(！FileExists(FileName）)
｛//如果文件不存在
ShowMessageb（"无法在应用程序的文件夹找到IC卡读写卡器动态库”)；
return； //返回
}
HINSTANCE hDll；
//加载动态库
hDll=LoadLibrary(FileName.c_str（））；
//提取动态库
piccrequestex = （unsigned char （__stdcall *piccrequestex）（unsigned char *serial)）GetProcAddress(hDll," piccrequeste")；
//调用函数
Myserial[0］ = 0x18;
Myserial［1］ = 0x18；
Myserial［2］ = 0x18；
Myserial[3] = 0x18;
//调用函数
status = piccrequestex （myserial);
//返回值处理
switch(status)
{
case 0:
//TO-DO相应的处理,请在以下加入代码
break;
case 1:
break；
//。。.
｝

函数名:piccauthkey1
功能
密码认证方式1,用外部密码认证，必须指定外部密码.本函数必须在piccrequest或piccrequestex函数执行之后运行，并且要紧接着调用，中途不能调用其他函数。
原始声明
unsigned char __stdcall piccauthkey1(unsigned char *serial,unsigned char area，unsigned char keyA1B0，unsigned char ＊picckey)
输入
1、＊serial指向存放选中卡序列号的数组，此序列号必须是选中卡的。
2、area是需要认证的区号,0-15中的某个数。
3、keyA1B0为0时以B密码来认证,为非0时以A密码来认证.刚出厂的卡以A密码来认证。
4、*picckey 指向存放卡密码的数组（6个char的密码数组）。
返回
返回unsigned char值。
返
回
值
说
明
0
操作成功，该卡的密码已认证通过，可以进运读写操作了。
11
密码装载失败。
12
密码认证失败。
21
本函数需要引用的动态库ICUSB.DLL不在当前目录下。
22
动态库或驱动程序异常,解决方法是退出程序，拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。dll到正确的位置.
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。
27
USB传输不稳定导致传输的字符不全。不需理会这个错误，因为基本上是不会出现这个错误的。
28
USB传输不稳定导致CRC校验错。不需理会这个错误，因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释

函数名：piccauthkey2
功能
密码认证方式2，用芯片内部密码认证，该密码存放在芯片的只写区域（用pcdwritekeytoe2写密码）,认证时通过芯片内部纳米线路传输，保密性极强，能小心剖开芯片，再用连上纳米线路拦截恐怕只有请外星人出马了。本函数必须在piccrequest或piccrequestex函数执行之后运行，并且要紧接着调用,中途不能调用其他函数.
原始声明
unsigned char __stdcall piccauthkey2（unsigned char ＊serial,unsigned char area，unsigned char keyA1B0)
输入
1、*serial指向存放选中卡序列号的数组(4个char),此序列号必须是选中卡的.
2、area是需要认证的区号，0—15中的某个数。
3、keyA1B0为0时以B密码来认证，为非0时以A密码来认证。刚出厂的卡以A密码来认证。
返回
返回unsigned char值.

0
操作成功，该卡的密码已认证通过，可以进运读写操作了.
11
密码装载失败.
12
密码认证失败。
21
本函数需要引用的动态库ICUSB.DLL不在当前目录下。
22
动态库或驱动程序异常,解决方法是退出程序，拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。dll到正确的位置.
24
操作超时.可能是电脑中毒导致USB帧传递调度缓慢,或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。
27
USB传输不稳定导致传输的字符不全.不需理会这个错误，因为基本上是不会出现这个错误的。
28
USB传输不稳定导致CRC校验错.不需理会这个错误，因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释

函数名：pcdwritekeytoe2
功能
将密码写入芯片内部保密性极高的只写区域,此函数写入密码仅仅是为了piccauthkey2函数的使用.
原始声明
unsigned char __stdcall pcdwritekeytoe2（unsigned char area，unsigned char keyA1B0，unsigned char *picckey)

输入
1、area是需要认正的区号,0—15中的某个数。
2、keyA1B0为0时以B密码来认证，为非0时以A密码来认证。刚出厂的卡以A密码来认证。
3、*picckey 指向存放卡密码的数组（6个char的密码数组)。
返回
返回unsigned char值。

0
写密码成功
15
写密码错误
21
本函数需要引用的动态库ICUSB。DLL不在当前目录下.
22
动态库或驱动程序异常，解决方法是退出程序,拔出IC卡读写器,重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。dll到正确的位置。
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。
27
USB传输不稳定导致传输的字符不全。不需理会这个错误，因为基本上是不会出现这个错误的。
28
USB传输不稳定导致CRC校验错。不需理会这个错误，因为基本上是不会出现这个错误的.
其他
未知错误
例子及注释

函数名：piccread
功能
读出一块的数据，也就是16个字节。必须在执行piccrequest或
Piccrequestex函数，接着执行piccauthkey1或 piccauthkey2函数，然后执行piccread才能成功读出一块的数据。
原始声明
unsigned char __stdcall piccread（unsigned char block，unsigned char ＊piccdata）
输入
1、block是IC卡的绝对块号,当需要读IC卡的第x区的第y块时,绝对块号必须是block = x * 4 + y。
2、＊piccdata是指向下标个数大于16的数组，作为返回16个字节的卡数据的缓存。
返回
返回unsigned char值,并将卡本块的数据传值到＊piccdata指向的数组中。
返
回
值
说
明
0
操作成功,读出的数据有效。
13
读本块失败，原因是本块所对应的区还没通过密码认证.
21
本函数需要引用的动态库ICUSB。DLL不在当前目录下.
22
动态库或驱动程序异常，解决方法是退出程序，拔出IC卡读写器,重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE.dll到正确的位置.
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题,解决方法是重启电脑或重新拔插IC卡读写器。
27
USB传输不稳定导致传输的字符不全。不需理会这个错误,因为基本上是不会出现这个错误的。
28
USB传输不稳定导致CRC校验错。不需理会这个错误，因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释

函数名：piccwrite
功能
读出一块的数据，也就是16个字节。必须在执行piccrequest或
Piccrequestex函数,接着执行piccauthkey1或 piccauthkey2函数,然后执行piccwrite才能成功写进一块的数据。
原始声明
unsigned char __stdcall piccwrite(unsigned char block,unsigned char ＊piccdata)
输入
1、block是IC卡的绝对块号，当需要读IC卡的第x区的第y块时，绝对块号必须是block = x ＊ 4 + y。
2、*piccdata是指向下标个数大于16的数组,特别提醒在调用piccwrite之前，必须对piccdata数组明确赋值,千万不能写进不明数据，特别对是存放卡权限的第3块,更要明确写入，否则极有可能导致卡作废。
返回
返回unsigned char值。
返
回
值
说
明
0
操作成功，写进数据有效。
14
写本块失败，原因是本块所对应的区还没通过密码认证.。
21
本函数需要引用的动态库ICUSB。DLL不在当前目录下.
22
动态库或驱动程序异常,解决方法是退出程序,拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE.dll到正确的位置。
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。
27
USB传输不稳定导致传输的字符不全。不需理会这个错误，因为基本上是不会出现这个错误的。
28
USB传输不稳定导致CRC校验错。不需理会这个错误，因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释

函数名:picchalt
功能
休眠选中卡,卡一旦被休眠，将不能再次被选中、不能被读被写。必须得拿卡离开感应区，再次放卡才能再次选中和读写卡。休眠卡功能一般用在只能操作一次的情况下，比如刷一次卡只扣一次钱的情况.
原始声明
unsigned char __stdcall picchalt()
输入
不用输入
返回
返回unsigned char值.
返
回
值
说
明
0
操作成功,。
21
本函数需要引用的动态库ICUSB。DLL不在当前目录下。
22
动态库或驱动程序异常，解决方法是退出程序,拔出IC卡读写器，重装驱动程序再插上IC卡读写器重试，或者重新拷贝动态库OUR_MIFARE。dll到正确的位置。
24
操作超时。可能是电脑中毒导致USB帧传递调度缓慢，或者是IC卡读写器有问题，解决方法是重启电脑或重新拔插IC卡读写器。
27
USB传输不稳定导致传输的字符不全。不需理会这个错误,因为基本上是不会出现这个错误的。
28
USB传输不稳定导致CRC校验错。不需理会这个错误，因为基本上是不会出现这个错误的。
其他
未知错误
例子及注释

函数名：piccchangesinglekey
功能
超强写卡,使用些函数可以一次性写整个区的第0块、第1块、第2块信息。
原始声明
unsigned char __stdcall piccchangesinglekey（unsigned char ctrlword,unsigned char ＊serial，unsigned char area , unsigned char keyA1B0，unsigned char ＊piccoldkey，unsigned char *piccnewkey）
输入
1、ctrlword读卡的控制字，ctrlword是一个字节,相当于八个位，每个位只有0和1两种状态：

推荐使用方法如下：
//先定义以下常量
＃define NEEDSERIAL 0x08
举例：
//以下控制字含义：仅更改指定序列号的卡密码
Ctrlword = NEEDSERIAL
//以下控制字含义：更改任意卡密码
Ctrlword = 0

2、serial只需指向一个至少已分配了4个char空间的可写数组 unsigned char *指针， serial的下标由0开始。如果在控制字中没有指定NEEDSERIAL ，则Serial数组的内容无需赋值，因为此数组仅用于返回值。如果指定了NEEDSERIAL，则必须为该数组的内容赋值。

3、a