Функция UnlockFileEx снимает блокировку с области в открытом файле. Эта функция может действовать или синхронно или асинхронно.
Синтаксис
BOOL UnlockFileEx( HANDLE hFile, // дескриптор файла DWORD dwReserved, // зарезервировано DWORD nNumberOfBytesToUnlockLow, // младшая часть длины DWORD nNumberOfBytesToUnlockHigh, // старшая часть длины LPOVERLAPPED lpOverlapped // начало области блокировки ); |
Параметры
hFile
[in] Дескриптор файла, который должен деблокировать существующую блокированную область. Дескриптор должен быть, создан с правом доступа или GENERIC_READ или GENERIC_WRITE . Для получения дополнительной информации, см. Защита файла и права доступа.dwReserved
Параметр зарезервирован; должен быть нуль.nNumberOfBytesToUnlockLow
[in] Младшая часть длины деблокируемого блока байтов.nNumberOfBytesToUnlockHigh
[in] Старшая часть длины деблокируемого блока байтов.lpOverlapped
[in] Указатель на структуру OVERLAPPED, которую функция использует с запросом на снятие блокировки. Эта структура содержит смещение в файле, с которого начинается область снятия блокировки.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль или ПУСТО (NULL). Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.
Замечания
Разблокирование области файла снимает перед этим полученную блокировку файла. Область снятия блокировки должна точно соответствовать существующей блокированной области. Две смежных области файла не могут быть заблокированы отдельно, а затем разблокированы, как использующаяся единая область, которая охватывает обе блокированных области.
Если процесс заканчивает работу с частью блокированного или закрытого файла, который имеет ожидающие обработки блокировки, они отменяются операционной системой. Однако, время, которое требуется операционной системе, чтобы снять эти блокировки, зависит от доступных ресурсов системы. Поэтому рекомендуется, чтобы ваш процесс, заканчивая работу, явно деблокировал все файлы, которые он заблокировал . Если это не сделать, доступ к этим файлам может быть отклонен, пока операционная система с них не снимет блокировку.
Смотри также
Обзор Управление файлами, Функции для файлового ввода-вывода (I/O), CreateFile, LockFile, LockFileEx, OVERLAPPED, UnlockFile
|
Размещение и совместимость UnlockFileEx |
||
| К |
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 |
Нет |
|
| Замечания по платформе |
Не имеется |
|