ePass1000 Full ActiveX Control Reference Manual Version 2.0
Error Code Value
| Return Status | Description | Value(HEX) | Value(DEC) |
| FT_COMMUNICATIONS_ERROR | Exception occured during transfer data between device and driver. Driver recerved an invalid response from the device. Rarely occur. Try again, reboot the machine and restart the application. | 0x08 | 8 |
| FT_INVALID_RESP_SIZE | Abnormal response received from the device. Rarely occur. Try again, reboot the machine and restart the application. | 0x0D | 13 |
ChangeDir
The ChangeDir method changes the current directory.
HRESULTChangeDir( [in] long , [in] long , [in[ unsigned char* , );
Parameters
lFlags[in] A bit mask defining the options for directory. changing. You may use OR operation to enable one or more options :
| Flag | Meaning | |
|---|---|---|
| EPAS_DIR_BY_ID | When this flag is set, lDirID parameter contain ID of the directory to be changed into. This flag may be combined with EPAS_DIR_FROM_MF or EPAS_DIR_FROM_CUR_DF. lDirID must be a 16-bit directory ID. | |
| EPAS_DIR_BY_LONG_ID | When this flag is set, lDirID parameter contain ID of the directory to be changed into. This flag may be combined with EPAS_DIR_FROM_MF, EPAS_DIR_FROM_CUR_DF, or EPAS_DIR_TO_PARENT. | |
| EPAS_DIR_BY_NAME | When this flag is set, pName parameter contain Application Name of the directory to be changed into. This flag cannot combine with others. | |
| EPAS_DIR_BY_GUID | When this flag is set, pName parameter contain Application GUID of the directory to be changed into. This flag cannot combine with others. | |
| EPAS_DIR_BY_GUID_STR | When this flag is set, pName parameter contain Application GUID string of the directory to be changed into. This flag cannot combine with others. |
此函数的lFlags参数在Private\Include\EPASSAPI.H中的Flags used for directory type部分
#define EPAS_DIR_BY_ID 0x00000100
#define EPAS_DIR_BY_LONG_ID 0x00000200#define EPAS_DIR_BY_NAME 0x00000300#define EPAS_DIR_BY_GUID 0x00000400#define EPAS_DIR_BY_GUID_STR 0x00000500#define EPAS_DIR_BY_MASK 0x00000f00
OpenDevice
The OpenDevice method finds and opens an ePass1000 for exclusive access, and create a session between application and device for further operation.
HRESULTOpenDevice( [in]long , [in]unsigned char* );
Requirement
Parameters
- lFlags
- [in]This parameter defines a bit mask of options for opening a device. You may use bit-wise OR operation to select more than one option. This parameter can be a combination of one or more of the following flags:
Flag Meaning EPAS_OPEN_FIRST Open the first found device. This flag can be combined with EPAS_OPEN_BY_NAME, EPAS_OPEN_BY_GUID or EPAS_OPEN_BY_GUID_STR. 0x00000000 EPAS_OPEN_NEXT Open the next device. This flag can be combined with EPAS_OPEN_BY_NAME, EPAS_OPEN_BY_GUID or EPAS_OPEN_BY_GUID_STR. 0x00000001 EPAS_OPEN_CURRENT Open the currently opened device. This flag can NOT be combined with other flags. 0x00000002 EPAS_OPEN_SPECIFIC Open the device, that has same serial number value as which specified by pAppID parameter. This flag can NOT be combined with other flags. 0x00000003 EPAS_OPEN_BY_NAME Open the device containing a directory name pointed to by pAppID. This parameter may be combined with EPAS_OPEN_FIRST or EPAS_OPEN_NEXT. 0x00000100 EPAS_OPEN_BY_GUID Open the device containing a directory GUID as specified by pAppID. This flag must combined with EPAS_OPEN_FIRST or EPAS_OPEN_NEXT. 0x00000200 EPAS_OPEN_BY_GUID_STR Open the device containing a directory GUID as specified by pAppID. This flag must combined with EPAS_OPEN_FIRST or EPAS_OPEN_NEXT. 0x00000300 pAppID - [in]This optional parameter provide additional information for the open. This parameter is only used if one of the following flags is assigned. If none of the flags below are assigned, pAppID should be set to NULL.
Flag Meaning EPAS_OPEN_SPECIFIC pAppID point to an array of two unsigned longs which specified serial number of the device to be opened. Use function to obtain a device's serial number. EPAS_OPEN_BY_NAME pAppID point to a NULL terminated string that specifies the Application Directory Name to open. If a device is opened, the current directory will be set to the directory ID defined by the Application Directory Name. EPAS_OPEN_BY_GUID pAppID point to an array of 16 bytes that specified the Application Directory GUID to open. If a device is opened, the current directory will be set to the directory ID defined by the Application Directory GUID. EPAS_OPEN_BY_GUID_STR pAppID point to a NULL terminated string that specifies the Application Directory GUID to open. If a device is opened, the current directory will be set to the directory ID defined by the Application Directory GUID. The string format is "{xxxxxxxx - xxxx - xxxx - xxxx - xxxxxxxxxxxx}". Dashes and braces are optional.
Remarks
The order of devices opened (first and next) is based on the order they were detected by the system. To enumerate all devices connected to the system, use EPAS_OPEN_FIRST and EPAS_OPEN_NEXT until FT_UNIT_NOT_FOUND is returned.
Application access to ePass1000 is exclusive. Only one application can open an ePass1000 at one time. If any other application attempt to open this ePass1000, will get return code FT_DEVICE_IN_USE.
You can open specific ePass1000 by combining EPAS_OPEN_FIRST, EPAS_OPEN_NEXT flags with EPAS_OPEN_BY_NAME , EPAS_OPEN_BY_GUID, or EPAS_OPEN_BY_GUID_STR.
If you known serial number of the ePass1000 you intend to open, use EPAS_OPEN_SPECIFIC.
Return Values
If the function succeeds, FT_SUCCESS returned.
If the library failed to open the device driver, FT_CANNOT_OPEN_DRIVER is returned.
If the library do not support version of the driver, FT_INVALID_DRVR_VERSION is returned.
If there is no device connected to the system currently, FT_UNIT_NOT_FOUND is returned.
If the device is already opened by another application, FT_DEVICE_IN_USE is returned.
For a list of all return codes, see .
/// Flags used by epas_OpenDevice()//#define EPAS_OPEN_NEXT 0x00000000#define EPAS_OPEN_FIRST 0x00000001#define EPAS_OPEN_CURRENT 0x00000002#define EPAS_OPEN_SPECIFIC 0x00000003#define EPAS_OPEN_MASK 0x00000007
#define EPAS_OPEN_BY_NAME 0x00000100
#define EPAS_OPEN_BY_GUID 0x00000200#define EPAS_OPEN_BY_GUID_STR 0x00000300#define EPAS_OPEN_BY_MASK 0x00000F00