Операции с файлами

JCFileClose

HRESULT JCFileClose(HFile hFile)

Закрывает дескриптор файла.

Параметры:
  • hFile (in) – дескриптор файла.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументы не верны.
  • E_JC_FILE_NOT_FOUND – файл не обнаружен.

JCFileCreate

HRESULT JCFileCreate(HFile * phFile, HDir hDir, WORD wFileName, WORD wFileSize, BOOL bPrivate)

Создаёт файл. Перед вызовом необходимо вызвать JCTokenLogin().

Параметры:
  • phFile (out) – указатель на дескриптор файла.
  • hDir (in) – родительская директория.
  • wFileName (in) – имя файла.
  • wFileSize (in) – размер файла.
  • bPrivate (in) – необходимо ли защищать доступ к файлу с помошью PIN-кода.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументы не верны.
  • E_JC_FILE_NOT_FOUND – файл не обнаружен.

JCFileDelete

HRESULT JCFileDelete(HFile hFile)

Удаляет файл. Перед вызовом необходимо вызвать JCTokenLogin().

Параметры:
  • hFile (in) – дескриптор файла.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументы не верны.
  • E_JC_FILE_NOT_FOUND – файл не обнаружен.

JCFileGetInfo

HRESULT JCFileGetInfo(HFile hFile, PFileInfo pFileInfo)

Возвращает информацию о файле.

Параметры:
  • hFile (in) – дескриптор файла.
  • pFileInfo (out) – указатель на структуру TFileInfo.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументы не верны.
  • E_JC_FILE_NOT_FOUND – файл не обнаружен.

JCFileOpen

HRESULT JCFileOpen(HFile * phFile, HDir hDir, WORD wFileName)

Открывает файл.

Параметры:
  • phFile (out) – указатель на дескриптор файла.
  • hDir (in) – родительская директория.
  • wFileName (in) – имя файла.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументы не верны.
  • E_JC_FILE_NOT_FOUND – файл не обнаружен.

JCFileRead

HRESULT JCFileRead(HFile hFile, WORD wOffset, WORD wLen, BYTE * pbData, DWORD dwDataLen)

Читает данные из файла.

Параметры:
  • hFile (in) – дескриптор файла.
  • wOffset (in) – смещение от начала файла.
  • wLen (in) – длина считываемого отрезка.
  • pbData (out) – указатель на буфер.
  • dwDataLen (in,out) – длина буфера.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументы не верны.
  • E_JC_FILE_NOT_FOUND – файл не обнаружен.

JCFilesEnumClose

HRESULT JCFilesEnumClose(HFilesEnum hFilesEnum)

Закрывает перечисление файлов.

Параметры:
  • hFilesEnum (in) – дескриптор перечисления.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументы не верны.

JCFilesEnumNext

HRESULT JCFilesEnumNext(HFilesEnum hFilesEnum, PFileInfo pInfo)

Возвращает следующий элемент из перечисления файлов.

Параметры:
  • hFilesEnum (in) – дескриптор перечисления.
  • pInfo (out) – указатель на структуру TFileInfo.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументов не верны.

JCFilesEnumOpen

HRESULT JCFilesEnumOpen(HFilesEnum * phFilesEnum, HDir hDir)

Открывает перечисление файлов в директории.

Параметры:
  • phFilesEnum (out) – указатель на дескриптор перечисления.
  • hDir (in) – дескриптор директории.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументов не верны.

JCFileWrite

HRESULT JCFileWrite(HFile hFile, WORD wOffset, const BYTE * pbData, WORD wLen)

Записывает данные в файл. Перед вызовом необходимо вызвать JCTokenLogin().

Параметры:
  • hFile (in) – дескриптор файла.
  • wOffset (in) – смещение от начала файла.
  • pbData (in) – указатель на буфер.
  • wLen (in) – длина данных в буфере.
Результат:

  • E_POINTER – недопустимый указатель.
  • E_INVALIDARG – один или более аргументов не верны.
  • E_JC_FILE_NOT_FOUND – файл не обнаружен.