Función FltInitializeFileLock (fltkernel.h)

Artículo
03/23/2023

La rutina FltInitializeFileLock inicializa una estructura de FILE_LOCK opaca que el autor de la llamada ha asignado desde el grupo paginado.

Sintaxis

VOID FLTAPI FltInitializeFileLock(
  [out] PFILE_LOCK FileLock
);

Parámetros

[out] FileLock

Puntero a una estructura de FILE_LOCK sin inicializar.

Valor devuelto

None

Observaciones

La estructura FILE_LOCK es opaca: es decir, sus miembros están reservados para uso del sistema.

Una vez inicializado, la estructura FILE_LOCK se puede usar para bloquear un intervalo de bytes en un archivo llamando a FltProcessFileLock.

Se trata de un error de programación para llamar a FltInitializeFileLock para una estructura de FILE_LOCK que ya ha sido inicializada por FltInitializeFileLock o FltAllocateFileLock, a menos que una llamada posterior a FltUninitializeFileLock no haya inicializado la estructura.

Cuando la estructura de FILE_LOCK ya no es necesaria, se puede anular inicializar llamando a FltUninitializeFileLock. La estructura de FILE_LOCK sin inicializar se puede inicializar para su reutilización mediante una llamada a FltInitializeFileLock.

Para asignar e inicializar una nueva estructura de FILE_LOCK opaca, llame a FltAllocateFileLock.

Para liberar una estructura de FILE_LOCK inicializada, llame a FltFreeFileLock.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP SP2
Servidor mínimo compatible	Windows Server 2003 SP1
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	FltMgr.lib
Archivo DLL	Fltmgr.sys
IRQL	<= APC_LEVEL