ePass1000 C/C++ API Reference Manual Version 2.0 |
The epas_GetFileInfo function retrieve information on a file or directory that is associated with the given ID in the current directory.
EPAS_STATUS EPAS_API epas_GetFileInfo( EPAS_HANDLE hContextHandle, /*[in]*/ unsigned long ulFlags, /*[in]*/ unsigned long ulID, /*[in]*/ unsigned char* pucName, /*[in]*/ PEPAS_FILEINFO pFileInfo, /*[out]*/ unsigned long ulFileInfoSize /*[in]*/ );
epas_CreateContext, epas_OpenDevice
Flag | Meaning |
---|---|
0 | Retrieve information on a file defined by ulID. |
EPAS_DIR_BY_ID | Retrieve information on a directory defined by ulID. The ulID must be a 16-bit directory ID. |
EPAS_DIR_BY_LONG_ID | Retrieve information on a directory defined by ulID. |
EPAS_DIR_BY_NAME | Retrieve information on a directory by Application Directory Name as defined by pucName. |
EPAS_DIR_BY_GUID | Retrieve information on a directory by Application Directory GUID as defined by pucName. |
EPAS_DIR_BY_GUID_STR | Retrieve information on a directory by Application Directory GUID string as defined by pucName. |
Flag | Meaning |
---|---|
0 | ulID is an integer value in the range of 0 to 0xEFFF. |
EPAS_DIR_BY_ID | ulID is an integer value in the range of 0 to 0xEFFF. |
Flag | Meaning |
---|---|
EPAS_DIR_BY_NAME | Pointer to a NULL terminate string which defines Directory Application Name. This name must be device unique. |
EPAS_DIR_BY_GUID | Pointer to 16 byte array which defines Directory Application GUID. This GUID must be device unique. |
EPAS_DIR_BY_GUID_STR | Pointer to a NULL terminated string that is the Application Directory GUID of the directory to be retrieved information on. The string format is "{xxxxxxxx - xxxx - xxxx - xxxx - xxxxxxxxxxxx }". Dashes and braces are optional. |
For directory information, pFileInfo will return the ID of the directory.
For file information, pFileInfo will return access setting for read, write and cryptographic operation. To retrieve granted access rights of a file, you should use epas_OpenFile function with a flag of zero.
This function automatically closes current opened file.
If the function succeeds, FT_SUCCESS returned.
If the specified file does not exist, FT_FILE_NOT_FOUND is returned.
If the specified directory does not exist, FT_DIR_NOT_FOUND is returned.
For a list of all return codes, see Status Return Values.
epas_CreateFile, epas_DeleteFile, epas_OpenFile, epas_CloseFile, epas_Read, epas_Write, epas_CreateDir, epas_DeleteDir, epas_GetCurrentDir, epas_ChangeDir, epas_Directory