DL FsOpenFile

FILE_HANDLE_T DL_FsOpenFile( WCHAR* uri, DL_FS_OPEN_MODE_T open_mode, DL_FS_OWNER_T owner_id );

Описание

Функция возвращает идентификатор открытого файла, который нужен для большинства функций по работе с файлами

Параметры

1. WCHAR* uri

   Путь в файловой системе, по которому лежит открываемый файл.

2. DL_FS_OPEN_MODE_T open_mode

   Указывает, в каком режиме нужно открыть файл.

3. DL_FS_OWNER_T owner_id

   Идентификатор приложения в прошивке, которое открывает файл (параметр необязательный, можно 0).

Режимы файлов

DL_FS_READ_MODE	Открыть только для чтения, с начала и только если файл существует
DL_FS_WRITE_MODE	Открыть только для записи, если файл существует - перезапишется пустым, если нет - создастся.
DL_FS_WRITE_EXIST_MODE	Открыть только для записи, только если файл ещё не существует
DL_FS_APPEND_MODE	Открыть только для записи в конец файла; если файла нет, он создаётся
DL_FS_READ_PLUS_MODE	Открыть для чтения и записи, только если файл существует
DL_FS_WRITE_PLUS_MODE	Открыть для чтения и записи; если файл существует - он будет перезаписан
DL_FS_WRITE_EXIST_PLUS_MODE	Открыть для чтения и записи, только если файл существует
DL_FS_APPEND_PLUS_MODE	Открыть для чтения и записи в конец файла; если файла нет, он создаётся

Возвращаемые значения

В случае неудачи, функция возвращает FILE_HANDLE_INVALID, иначе - идентификатор открытого файла

Примечания

1. Функция работает аналогично функции fopen из стандартной библиотеки C stdio. Почитать о ней можно здесь: [Wikipedia: Файловый ввод/вывод в языке Си]
2. Для корня диска а пути можно полностью не писать, под адресом ALARMCLOCK функция будет понимать /a/ALARMCLOCK
3. Перед путем к файлу не обязательно вставлять file:/, то есть file://a/test.txt будет эквивалентно /a/test.txt