Funzione FltInitializeFileLock (fltkernel.h)

Articolo
02/26/2024

La routine FltInitializeFileLock inizializza una struttura FILE_LOCK opaca allocata dal chiamante dal pool di paging.

Sintassi

VOID FLTAPI FltInitializeFileLock(
  [out] PFILE_LOCK FileLock
);

Parametri

[out] FileLock

Puntatore a una struttura di FILE_LOCK non inizializzata.

Valore restituito

nessuno

Osservazioni

La struttura FILE_LOCK è opaca, ovvero i relativi membri sono riservati per l'uso del sistema.

Dopo l'inizializzazione, la struttura FILE_LOCK può essere usata per bloccare un intervallo di byte in un file chiamando FltProcessFileLock.

Si tratta di un errore di programmazione per chiamare FltInitializeFileLock per una struttura FILE_LOCK che è già stata inizializzata da FltInitializeFileLock o FltAllocateFileLock, a meno che la struttura non sia stata inizializzata da una chiamata successiva a FltUninitializeFileLock.

Quando la struttura FILE_LOCK non è più necessaria, può essere inizializzata chiamando FltUninitializeFileLock. La struttura di FILE_LOCK non inizializzata può quindi essere inizializzata per il riutilizzo chiamando FltInitializeFileLock.

Per allocare e inizializzare una nuova struttura FILE_LOCK opaca, chiamare FltAllocateFileLock.

Per liberare una struttura di FILE_LOCK inizializzata, chiamare FltFreeFileLock.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP SP2
Server minimo supportato	Windows Server 2003 SP1
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (include Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL