FltInitializeFileLock, fonction (fltkernel.h)
La routine FltInitializeFileLock initialise une structure de FILE_LOCK opaque que l’appelant a allouée à partir du pool paginé.
Syntaxe
VOID FLTAPI FltInitializeFileLock(
[out] PFILE_LOCK FileLock
);
Paramètres
[out] FileLock
Pointeur vers une structure FILE_LOCK non initialisée.
Valeur de retour
Aucun
Remarques
La structure FILE_LOCK est opaque : autrement dit, ses membres sont réservés à une utilisation système.
Une fois initialisée, la structure FILE_LOCK peut être utilisée pour verrouiller une plage d’octets dans un fichier en appelant FltProcessFileLock.
Il s’agit d’une erreur de programmation pour appeler FltInitializeFileLock pour une structure FILE_LOCK qui a déjà été initialisée par FltInitializeFileLock ou FltAllocateFileLock, sauf si la structure a été non initialisée par un appel ultérieur à FltUninitializeFileLock.
Lorsque la structure FILE_LOCK n’est plus nécessaire, elle peut être non initialisée en appelant FltUninitializeFileLock. La structure FILE_LOCK non initialisée peut ensuite être initialisée pour la réutilisation en appelant FltInitializeFileLock.
Pour allouer et initialiser une nouvelle structure de FILE_LOCK opaque, appelez FltAllocateFileLock.
Pour libérer une structure de FILE_LOCK initialisée, appelez FltFreeFileLock.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP SP2 |
| serveur minimum pris en charge | Windows Server 2003 SP1 |
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |