На главную

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 | Скачать Вниз

LockFile



The LockFile function locks a region in an open file. Locking a region prevents other processes from accessing the region.

BOOL LockFile(

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


Parameters

hFile

Identifies the file with a region to be locked. The file handle must have been created with GENERIC_READ or GENERIC_WRITE access to the file (or both).

dwFileOffsetLow

Specifies the low-order word of the starting byte offset in the file where the lock should begin.

dwFileOffsetHigh

Specifies the high-order word of the starting byte offset in the file where the lock should begin.

nNumberOfBytesToLockLow

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

nNumberOfBytesToLockHigh

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



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

Locking a region of a file gives the locking process exclusive access to the specified region. File locks are not inherited by processes created by the locking process.
Locking a region of a file denies all other processes both read and write access to the specified region. Locking a region that goes beyond the current end-of-file position is not an error.
Locks may not overlap an existing locked region of the file.
The UnlockFile function unlocks a file region locked by LockFile.

See Also

CreateFile, UnlockFile


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

LockFile



Функция LockFile запирает регион в открытом файле. Блокировка региона мешает процессы чтобы получать регион.

BOOL LockFile(

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


Параметры

hFile

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

dwFileOffsetLow

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

dwFileOffsetHigh

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

nNumberOfBytesToLockLow

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

nNumberOfBytesToLockHigh

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



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

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

Замечания

Блокировка области файла дает блокировку процесса исключительного доступа к определенной области. Файловая блокировка не унаследована процессами созданными блокировкой процесса.
Блокировка области файла запрещит все другие процессы как прочитанные так и доступ записи к определенной области. Блокировка области, которая превосходит текущим концом--файловой позиции - не ошибка.
Блокировка не может перекрывать существующую закрытую область файла.
Функция UnlockFile деблокирует файловую область запертую LockFile.

Смотри Также

CreateFile, UnlockFile


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