Fonction FsRtlGetNextFileLock (ntifs.h)

Article
02/29/2024

La routine FsRtlGetNextFileLock est utilisée pour énumérer les verrous de plage d’octets qui existent actuellement pour un fichier spécifié.

Syntaxe

PFILE_LOCK_INFO FsRtlGetNextFileLock(
  [in] PFILE_LOCK FileLock,
  [in] BOOLEAN    Restart
);

Paramètres

[in] FileLock

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.

[in] Restart

Définissez sur TRUE si l’énumération doit commencer au début de la liste des verrous de plage d’octets. Définissez sur FALSE si vous reprenez l’énumération à partir d’un appel précédent.

Pour énumérer tous les verrous de plage d’octets pour un fichier donné, utilisez FsRtlGetNextFileLock comme suit :

for (p = FsRtlGetNextFileLock( FileLock, TRUE );
     p != NULL;
     p = FsRtlGetNextFileLock( FileLock, FALSE )) {
        // Process the lock information pointed to by p
}

Valeur retournée

FsRtlGetNextFileLock retourne un pointeur vers la structure FILE_LOCK_INFO pour le verrou de plage d’octets suivant, le cas échéant. S’il n’y a plus de verrous de plage d’octets pour ce fichier, FsRtlGetNextFileLock retourne NULL.

Remarques

Les verrous de plage d’octets ne sont énumérés dans aucun ordre particulier.

Notez que, étant donné que l’état d’énumération actuel est stocké dans la structure FILE_LOCK, les appelants doivent veiller à synchroniser les appels à FsRtlGetNextFileLock et à éviter de modifier les structures qu’ils retournent. Si plusieurs threads tentent d’utiliser FsRtlGetNextFileLock en même temps, les résultats seront imprévisibles et l’énumération ne sera pas terminée de manière fiable.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport)