DL FsOpenFile: различия между версиями
(http://www.purchase-clomid-online.com/#79745 where can i buy clomid - clomid ovulation induction http://www.buyphenterminediet.org/#54298 phentermine without prescription where to buy canada - buy cod) | Synergy (обсуждение | вклад) | ||
| (не показано 7 промежуточных версий 5 участников) | |||
| Строка 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> |
| − | + | == Описание == | |
| + | Функция возвращает идентификатор открытого файла, который нужен для большинства функций по работе с файлами | ||
| − | + | == Параметры == | |
| + | #'''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''' || Открыть для чтения и записи в конец файла; если файла нет, он создаётся | ||
| + | |} | ||
| − | + | == Возвращаемые значения == | |
| + | В случае неудачи, функция возвращает FILE_HANDLE_INVALID, иначе - идентификатор открытого файла | ||
| + | |||
| + | == Примечания == | ||
| + | #Функция работает аналогично функции '''fopen''' из стандартной библиотеки C stdio. Почитать о ней можно здесь: [[http://ru.wikipedia.org/wiki/%D0%A4%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2%D1%8B%D0%B9_%D0%B2%D0%B2%D0%BE%D0%B4/%D0%B2%D1%8B%D0%B2%D0%BE%D0%B4_%D0%B2_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B5_%D0%A1%D0%B8 Wikipedia: Файловый ввод/вывод в языке Си]] | ||
| + | #Для корня диска '''а''' пути можно полностью не писать, под адресом '''ALARMCLOCK''' функция будет понимать '''/a/ALARMCLOCK''' | ||
| + | #Перед путем к файлу не обязательно вставлять '''file:/''', то есть '''file://a/test.txt''' будет эквивалентно '''/a/test.txt''' | ||
| + | |||
| + | [[Категория:Функции Файловой Системы]] | ||
Текущая версия на 04:46, 8 апреля 2019
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: Файловый ввод/вывод в языке Си]
- Для корня диска а пути можно полностью не писать, под адресом ALARMCLOCK функция будет понимать /a/ALARMCLOCK
- Перед путем к файлу не обязательно вставлять file:/, то есть file://a/test.txt будет эквивалентно /a/test.txt