На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

UnlockFile



The UnlockFile function unlocks a region in an open file. Unlocking a region enables other processes to access the region.

BOOL UnlockFile(

HANDLE hFile, // handle of file to unlock
DWORD dwFileOffsetLow, // low-order word of lock region offset
DWORD dwFileOffsetHigh, // high-order word of lock region offset
DWORD nNumberOfBytesToUnlockLow, // low-order word of length to unlock
DWORD nNumberOfBytesToUnlockHigh // high-order word of length to unlock
);


Parameters

hFile

Identifies a file that contains a region locked with LockFile. The file handle must have been created with either GENERIC_READ or GENERIC_WRITE access to the file.

dwFileOffsetLow

Specifies the low-order word of the starting byte offset in the file where the locked region begins.

dwFileOffsetHigh

Specifies the high-order word of the starting byte offset in the file where the locked region begins.

nNumberOfBytesToUnlockLow

Specifies the low-order word of the length of the byte range to be unlocked.

nNumberOfBytesToUnlockHigh

Specifies the high-order word of the length of the byte range to be unlocked.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

Unlocking a region of a file releases a lock on the file. The region to unlock must correspond exactly to an existing locked region. For example, two adjacent regions of a file cannot be locked separately and then unlocked as a single region that spans both locked regions.
A process should not be terminated with a portion of a file locked and a file that has locked regions should not be closed.
This function works on a file allocation table (FAT) - based file system only if the operating system is running SHARE.EXE.

See Also

CreateFile, LockFile


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

UnlockFile



Функция UnlockFile деблокирует регион в открытом файле. Разблокировка региона позволяет процессы, чтобы иметь доступ к региону.

BOOL UnlockFile(

РУЧКА hFile, // ручка файла, чтобы деблокировать DWORD dwFileOffsetLow, // младшее слово компенсации региона замка DWORD dwFileOffsetHigh, // старшего слова компенсации региона замка DWORD nNumberOfBytesToUnlockLow, // младшего слова длины, чтобы деблокировать старшее слово DWORD nNumberOfBytesToUnlockHigh // длины, чтобы деблокироваться
);


Параметры

hFile

Идентифицирует файл, который содержит регион запирался LockFile. Файловая ручка по-видимому создана с GENERIC_READ или доступом GENERIC_WRITE к файлу.

dwFileOffsetLow

Определяет младшее слово стартовой байтовой компенсации в файле где закрытый регион начинается.

dwFileOffsetHigh

Определяет старшее слово стартовой байтовой компенсации в файле где закрытый регион начинается.

nNumberOfBytesToUnlockLow

Определяет младшее слово длины байтового дипазона, чтобы быть деблокированн.

nNumberOfBytesToUnlockHigh

Определяет старшее слово длины байтового дипазона, чтобы быть деблокированн.



Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Разблокировка области файла выпускает блокировку в файл. Область, чтобы деблокировать, должно переписываться точно в существующую закрытую область. Например, две смежных области файла не мочь запираться отдельно и затем деблокированное как единственная область, которая распределяет (вращать) обе закрытых области.
Процесс не должен быть расторгнутым с частью файла запертого и файл, который запер области не должно закрывано.
Эта функция работает в файловой таблице распределения (ЖИРА) - основавшее файловую систему только если операционная система выполняет SHARE.EXE.

Смотри Также

CreateFile, LockFile


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz