DL FsOpenFile: различия между версиями

Текущая версия на 04:46, 8 апреля 2019

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

Содержание

1 Описание
2 Параметры
- 2.1 Режимы файлов
3 Возвращаемые значения
4 Примечания

Описание

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

Параметры

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: Файловый ввод/вывод в языке Си]
Для корня диска а пути можно полностью не писать, под адресом ALARMCLOCK функция будет понимать /a/ALARMCLOCK
Перед путем к файлу не обязательно вставлять file:/, то есть file://a/test.txt будет эквивалентно /a/test.txt

@@ Строка 1: / Строка 1: @@
-<tt>FILE_HANDLE_T '''DL_FsOpenFile'''( WCHAR* uri, DL_FS_OPEN_MODE_T open_mode, DL_FS_OWNER_T owner_id );</tt>
+<tt>FILE_HANDLE_T '''DL_FsOpenFile'''( WCHAR* uri, DL_FS_OPEN_MODE_T open_mode, DL_FS_OWNER_T owner_id );</tt><metadesc>Функция возвращает идентификатор открытого файла, который нужен для большинства функций по работе с файлами</metadesc>
-TdJdQm  <a href="http://cfmseroexqwo.com/">cfmseroexqwo</a>, [url=http://jicfroqrletv.com/]jicfroqrletv[/url], [link=http://gqjxzunzduxg.com/]gqjxzunzduxg[/link], http://efaiwtnrxxpi.com/
+== Описание ==
+Функция возвращает идентификатор открытого файла, который нужен для большинства функций по работе с файлами
-http://topsailnet.com/#39145 buy ambien - buy ambien no prescription http://www.americanindependentwriters.net/#35827 buy ativan no prescription - ativan
+== Параметры ==
+#'''WCHAR* uri'''
+#:Путь в файловой системе, по которому лежит открываемый файл.
+#'''DL_FS_OPEN_MODE_T open_mode'''
+#:Указывает, в каком [[#Режимы файлов|режиме]] нужно открыть файл.
+#'''DL_FS_OWNER_T owner_id'''
+#:Идентификатор приложения в [[Прошивка|прошивке]], которое открывает файл (параметр необязательный, можно '''0''').
+=== Режимы файлов ===
+{| border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse"
+|-
+| style="width:200px" |'''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''' || Открыть для чтения и записи в конец файла; если файла нет, он создаётся
+|}
 == Возвращаемые значения ==