Macro FsRtlAreThereCurrentFileLocks (ntifs.h)

  • Article

La macro FsRtlAreThereCurrentFileLocks vérifie si des verrous de plage d’octets existent pour le fichier spécifié.

Syntaxe

void FsRtlAreThereCurrentFileLocks(
   FL
);

Paramètres

FL

Pointeur vers la structure FILE_LOCK pour le fichier. Cette structure doit avoir été initialisée par un appel précédent à FsRtlAllocateFileLock ou FsRtlInitializeFileLock.

Valeur de retour

None

Remarques

Cette macro agit comme une fonction BOOLEAN, renvoyant TRUE si des verrous de plage d’octets existent pour le fichier spécifié ou FALSE si aucun n’existe.

Les systèmes de fichiers et les pilotes de filtre appellent souvent FsRtlAreThereCurrentFileLocks à partir de leurs routines FastIoCheckIfPossible .

Si un verrou de plage d’octets existe depuis l’ouverture du fichier spécifié, FsRtlAreThereCurrentFileLocks retourne TRUE, sauf si le FILE_LOCK approprié est réinitialisé. Si un verrou a été établi puis libéré, l’utilisation de FsRtlAreThereCurrentFileLocks peut empêcher inutilement l’attribution d’oplocks. Utilisez FsRtlAreThereCurrentOrInProgressFileLocks pour éviter ce problème.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête ntifs.h (inclure Ntifs.h)
IRQL N’importe quel niveau

Voir aussi

FsRtlAllocateFileLock

FsRtlAreThereCurrentOrInProgressFileLocks

FsRtlInitializeFileLock