FILE_HANDLE_T DL_FsOpenFile( WCHAR* uri, DL_FS_OPEN_MODE_T open_mode, DL_FS_OWNER_T owner_id );
Содержание
Описание
Функция возвращает идентификатор открытого файла, который нужен для большинства функций по работе с файлами
Параметры
- WCHAR* uri
- Путь в файловой системе, по которому лежит открываемый файл.
- DL_FS_OPEN_MODE_T open_mode
- Указывает, в каком режиме нужно открыть файл.
- 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, иначе - идентификатор открытого файла
Примечания
Функция работает аналогично функции fopen из стандартной библиотеки C stdio. Почитать о ней можно здесь: [Wikipedia: Файловый ввод/вывод в языке Си]