Функция UnlockFile деблокирует область в открытом файле. Разблокирование области дает возможность другим процессам обращаться к ней.
В качестве альтернативного способа задания такой области, используйте функцию UnlockFileEx.
Синтаксис
BOOL UnlockFile( HANDLE hFile, // дескриптор файла DWORD dwFileOffsetLow, // младшее слово начала DWORD dwFileOffsetHigh, // старшее слово начала DWORD nNumberOfBytesToUnlockLow, // младшее слово длины DWORD nNumberOfBytesToUnlockHigh // старшее слово длины |
Параметры
hFile
[in] Дескриптор файла, содержащий блокированную функцией LockFile область. Дескриптор файла, должен быть создан с правом доступа, или GENERIC_READ или GENERIC_WRITE. Для получения дополнительной информации, см. статью Защита файла и права доступа.dwFileOffsetLow
[in] Младшее слово смещения начального байта в файле, где начинается блокированная область.dwFileOffsetHigh
[in] Старшее слово смещения начального байта в файле, где начинается блокированная область.Windows 95/98/Me: параметр dwFileOffsetHigh, дополнительный знаковый разряд значения dwFileOffsetLow, должен быть 0 . Любое другое значение, должно быть отклонено.
nNumberOfBytesToUnlockLow
[in] Младшее слово длины деблокированной области байтов.nNumberOfBytesToUnlockHigh
[in] Старшее слово длины деблокированной области байтов.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.
Замечания
Разблокирование области файла снимает перед этим полученную блокировку файла. Область снятия блокировки должна точно соответствовать существующей блокированной области. Две смежных области файла не могут быть заблокированы отдельно, а затем разблокированы, как использующаяся единая область, которая охватывает обе блокированных области.
Если процесс заканчивает работу с частью блокированного или закрытого файла, который имеет ожидающие обработки блокировки, блокировки отменяются операционной системой. Однако, время, которое требуется операционной системе, чтобы снять эти блокировки, зависит от доступных ресурсов системы. Поэтому рекомендуется, чтобы ваш процесс, заканчивая работу, явно деблокировал все файлы, которые он заблокировал . Если это не сделать, доступ к этим файлам может быть отклонен, пока операционная система с них не снимет блокировку.
Эти функция работает с таблицей распределения файлов (FAT) - базовой файловой системой только в том случае, если операционная система запускает файл Share.exe.
Смотри также
Обзор Управление файлами, Функции для файлового ввода-вывода (I/O), CreateFile, LockFile, UnlockFileEx
|
Размещение и совместимость UnlockFile |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да |
| е |
Windows Me |
Да |
| н |
Windows 98 |
Да |
| т |
Windows 95 |
Да |
| С |
Windows Server 2003 |
Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Kernel32.lib |
|
| Используемая DLL | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
| - включено в |
Windows.h |
|
| Unicode |
Нет |
|
| Замечания по платформе |
Не имеется |
|