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

Статья
12/21/2024

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

Синтаксис

VOID FLTAPI FltInitializeFileLock(
  [out] PFILE_LOCK FileLock
);

Параметры

[out] FileLock

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

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

Никакой

Замечания

Структура 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 (include Fltkernel.h)
библиотеки	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL