chipstbankapi.h

基于挑战—应答模式的客户端认证程序

/* $Id: ChipsbankApi.h,v 1.5 2007/02/06 08:17:43 user Exp $ */
#ifndef CHIPSBANKAPI_H
#define CHIPSBANKAPI_H

//required umptool2090 v1.6.0

//version, compatible with api2080 v3.5
#define API_VERSION					4
#define API_MINOR_VERSION			42

//error defines
#define ERR_NO_ERROR					0
#define ERR_DISK_NOT_FOUND				1
#define ERR_CFG_TABLE_NOT_FOUND			2
#define ERR_BAD_PASSWORD				3
#define ERR_PRIVATE_ZONE_NOT_FOUND		4
#define ERR_DISK_NOT_OPENNED			5
#define ERR_HIDE_ZONE_NOT_FOUND			6
#define ERR_PASSWORD_NOT_FOUND			7
#define ERR_API_NOT_SUPPORTED			8
#define ERR_BAD_AUTHORIZE_KEY			9
#define ERR_BAD_LUN						10
#define ERR_LUN_LOCKED					11
#define ERR_FORMAT_ERROR				12
#define ERR_BAD_FILENAME				13
#define ERR_FILE_NOT_FOUND				14
#define ERR_CANNOT_GET_SIZE				15
#define ERR_SIZE_ERROR					16
#define ERR_ISO_WRITE_ERROR				17
#define ERR_UPDATE_CFG_TABLE_ERROR		18
#define ERR_DISK_READ_ERROR				19
#define ERR_DISK_WRITE_ERROR			20
#define ERR_MULTI_THREAD_NOT_SUPPORTED	21
#define ERR_CANNOT_REOPENED				22


//#define CHIPSBANK_API_DLL  __declspec(dllexport)
#define CHIPSBANK_API_DLL

#ifdef __cplusplus
    extern "C" {
#endif

//-------------------------Normal API ------------------------------------------------------------
CHIPSBANK_API_DLL HANDLE WINAPI OpenUsbDisk(PBYTE AuthorizeKey);
CHIPSBANK_API_DLL HANDLE WINAPI OpenUsbDiskEx(PBYTE AuthorizeKey, char DriverLetter);
CHIPSBANK_API_DLL BOOL WINAPI OpenUsbDiskFree(PBYTE AuthorizeKey, char DriverLetter, BOOL bSingle = TRUE);
CHIPSBANK_API_DLL void WINAPI CloseUsbDisk(HANDLE handle);
		
CHIPSBANK_API_DLL DWORD WINAPI GetPrivateZoneSize(HANDLE handle);//if return 0, no private Zone
CHIPSBANK_API_DLL BYTE WINAPI GetPrivateZoneLun(HANDLE handle, BYTE &Lun);
CHIPSBANK_API_DLL BOOL WINAPI ChangeAuthorizeKey(HANDLE handle, PBYTE OldAuthorizeKey,PBYTE NewAuthorizeKey);
CHIPSBANK_API_DLL BOOL WINAPI CheckAuthorizeKey(HANDLE handle, PBYTE AuthorizeKey);
CHIPSBANK_API_DLL BOOL WINAPI ReadPrivateUserSector(
	HANDLE handle,	
	DWORD SectoroffsetInBuf,	// Offset sectors in private buf, must be 0,1,2,...
	BYTE *p_user_data,			// Receive Data buf
	BYTE SectorNumber,			// Sectors(512 bytes per sector) to read
	BYTE Lun
	);
CHIPSBANK_API_DLL BOOL WINAPI WritePrivateUserSector(
	HANDLE handle, 
	DWORD SectoroffsetInBuf,	// Offset sectors in private buf, must be 0,1,2,...,
	BYTE *p_user_data,			// Data buf to write
	BYTE SectorNumber,			// Sectors(512 bytes per sector) to write
	BYTE Lun
	);

CHIPSBANK_API_DLL DWORD WINAPI GetHideZoneSize(HANDLE handle);//if return 0, no hide Zone
CHIPSBANK_API_DLL char WINAPI GetHideZoneDriveLetter(HANDLE handle, char &DriveLetter);
CHIPSBANK_API_DLL BYTE WINAPI GetHideZoneLun(HANDLE handle, BYTE &Lun);
CHIPSBANK_API_DLL BOOL WINAPI IsInHideZone(HANDLE handle, BYTE Lun);
CHIPSBANK_API_DLL BOOL WINAPI MountHideZoneAsDisk(HANDLE handle, BYTE Lun);
CHIPSBANK_API_DLL BOOL WINAPI UnMountHideZoneAsDisk(HANDLE handle, BYTE Lun);
CHIPSBANK_API_DLL BOOL WINAPI ChangeUserPassword(HANDLE handle, PBYTE OldUserPassword, PBYTE NewUserPassword);
CHIPSBANK_API_DLL BOOL WINAPI VerifyUserPassword(HANDLE handle, PBYTE UserPassword);

CHIPSBANK_API_DLL BOOL WINAPI IsCdrom(HANDLE handle, char DriveLetter);
CHIPSBANK_API_DLL BOOL WINAPI IsReadProtect(HANDLE handle, BYTE Lun);
CHIPSBANK_API_DLL BOOL WINAPI IsWriteProtect(HANDLE handle, BYTE Lun);
CHIPSBANK_API_DLL BOOL WINAPI SetDiskProtect(HANDLE handle, BYTE Lun, BOOL bCanRead, BOOL bCanWrite);
CHIPSBANK_API_DLL void WINAPI LockUsbDisk(HANDLE handle, BYTE Lun, BYTE &LockStatus);
CHIPSBANK_API_DLL void WINAPI UnLockUsbDisk(HANDLE handle, BYTE Lun, BYTE LockStatus);
CHIPSBANK_API_DLL DWORD WINAPI GetUsbDiskSize(HANDLE handle, BYTE Lun);
CHIPSBANK_API_DLL BOOL WINAPI SetUsbDiskSize(HANDLE handle, DWORD Lun0Size,DWORD Lun1Size,DWORD hZoneSize,DWORD pZoneSize);
CHIPSBANK_API_DLL BOOL WINAPI IsHighSpeed(HANDLE handle);
CHIPSBANK_API_DLL char* WINAPI GetUDiskLetter(HANDLE handle, DWORD dwMilliseconds);

CHIPSBANK_API_DLL BOOL WINAPI DiskFormat(HANDLE handle, BYTE Lun);//Format Current Logic Partition which has private sectors
CHIPSBANK_API_DLL int  WINAPI UpdateISOFileOfCDROMDriver(HANDLE handle, char* FileName);

CHIPSBANK_API_DLL BYTE WINAPI GetUDiskSerialNumber(HANDLE handle, char *SerialNumber);
CHIPSBANK_API_DLL BOOL WINAPI SetUDiskSerialNumber(HANDLE handle, char *SerialNumber);
CHIPSBANK_API_DLL WORD WINAPI GetPID(HANDLE handle, WORD &Pid);
CHIPSBANK_API_DLL BOOL WINAPI SetPID(HANDLE handle, WORD PID);
CHIPSBANK_API_DLL WORD WINAPI GetVID(HANDLE handle, WORD &Vid);
CHIPSBANK_API_DLL BOOL WINAPI SetVID(HANDLE handle, WORD VID);
CHIPSBANK_API_DLL char* WINAPI GetProductInfo(HANDLE handle, char* ProductInfo);
CHIPSBANK_API_DLL BOOL WINAPI SetProductInfo(HANDLE handle, char *ProductInfo);
CHIPSBANK_API_DLL char* WINAPI GetVendorInfo(HANDLE handle, char* VendorInfo);
CHIPSBANK_API_DLL BOOL WINAPI SetVendorInfo(HANDLE handle, char *VendorInfo);
CHIPSBANK_API_DLL WORD WINAPI GetVendorSerial(HANDLE handle);
CHIPSBANK_API_DLL void WINAPI GetUID(HANDLE handle, DWORD *pUid, DWORD *pUid0);
CHIPSBANK_API_DLL int  WINAPI GetError(HANDLE handle);		
//----------------------------------------------------------------------------------		
	
CHIPSBANK_API_DLL int WINAPI GetApiVersion(void);
CHIPSBANK_API_DLL int WINAPI GetApiMinorVersion(void);	

//get 2080/2090 ic type
CHIPSBANK_API_DLL int WINAPI GetICType(void);	
#ifdef __cplusplus
    }
#endif


#endif