Функция FltInitializeFileLock (fltkernel.h)

Статья
03/23/2023

Подпрограмма FltInitializeFileLock инициализирует непрозрачную структуру FILE_LOCK , выделенную вызывающим объектом из выгружаемого пула.

Синтаксис

VOID FLTAPI FltInitializeFileLock(
  [out] PFILE_LOCK FileLock
);

Параметры

[out] FileLock

Указатель на неинициализированную структуру FILE_LOCK .

Возвращаемое значение

None

Remarks

Структура FILE_LOCK непрозрачна: то есть ее члены зарезервированы для использования системой.

После инициализации структуру FILE_LOCK можно использовать для блокировки диапазона байтов в файле, вызвав FltProcessFileLock.

Вызов FltInitializeFileLock для FILE_LOCK структуры, которая уже была инициализирована FltInitializeFileLock или FltAllocateFileLock, является ошибкой программирования, если только структура не была не инициализирована последующим вызовом FltUninitializeFileLock.

Если структура FILE_LOCK больше не нужна, ее можно не инициализировать, вызвав FltUninitializeFileLock. Затем неинициализированную структуру FILE_LOCK можно инициализировать для повторного использования, вызвав FltInitializeFileLock.

Чтобы выделить и инициализировать новую непрозрачную структуру FILE_LOCK , вызовите FltAllocateFileLock.

Чтобы освободить инициализированную структуру FILE_LOCK , вызовите FltFreeFileLock.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2)
Минимальная версия сервера	Windows Server 2003 с пакетом обновления 1 (SP1)
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL