Fonction FltInitializeFileLock (fltkernel.h)
La routine FltInitializeFileLock initialise une structure opaque FILE_LOCK que l’appelant a allouée à partir d’un pool paginé.
Syntaxe
VOID FLTAPI FltInitializeFileLock(
[out] PFILE_LOCK FileLock
);
Paramètres
[out] FileLock
Pointeur vers une structure de FILE_LOCK non initialisée.
Valeur de retour
None
Remarques
La structure FILE_LOCK est opaque : c’est-à-dire que ses membres sont réservés à l’utilisation du 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 d’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 de FILE_LOCK non initialisée peut ensuite être initialisée pour être réutilisée en appelant FltInitializeFileLock.
Pour allouer et initialiser une nouvelle structure opaque FILE_LOCK , appelez FltAllocateFileLock.
Pour libérer une structure FILE_LOCK initialisée, appelez FltFreeFileLock.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP SP2 |
| Serveur minimal pris en charge | Windows Server 2003 SP1 |
| Plateforme cible | Universal |
| En-tête | fltkernel.h (inclure Fltkernel.h) |
| Bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |