Partager via


Fonction RxLockEnumerator (rxprocs.h)

RxLockEnumerator est appelé à partir d’un mini-redirecteur réseau pour énumérer les verrous de fichier sur un contrôleur fcb.

Syntaxe

BOOLEAN RxLockEnumerator(
  [in, out] IN OUT PMRX_SRV_OPEN SrvOpen,
  [in, out] IN OUT PVOID         *ContinuationHandle,
  [out]     OUT PLARGE_INTEGER   FileOffset,
  [out]     OUT PLARGE_INTEGER   LockRange,
  [out]     OUT PBOOLEAN         IsLockExclusive
);

Paramètres

[in, out] SrvOpen

Pointeur vers la structure SRV_OPEN sur le fcb à énumérer.

[in, out] ContinuationHandle

Pointeur vers un handle passé d’aller-retour représentant l’état de l’énumération. Si ce paramètre est un pointeur NULL , il s’agit du début d’une énumération de verrous.

[out] FileOffset

Pointeur vers le décalage de fichier du verrou retourné.

[out] LockRange

Pointeur vers la plage de verrous du verrou retourné.

[out] IsLockExclusive

Pointeur vers un booléen indiquant si le verrou retourné est un verrou exclusif.

Valeur retournée

RxLockEnumerator retourne TRUE en cas de réussite, indiquant que les données de verrou retournées sont valides. La routine RxLockEnumerator retourne ou FALSE en cas d’échec lorsqu’aucune donnée de verrou n’est trouvée ou que la fin de la liste des verrous a été atteinte.

Remarques

RxLockEnumerator est normalement appelé à partir d’un redirecteur min-redirecteur réseau pour énumérer les verrous de fichier sur un objet FCB. RxLockEnumerator obtient un verrou sur chaque appel. l’appelant doit donc conserver l’état d’énumération en interne. Par conséquent, un seul processus d’énumération peut être en cours à tout moment.

La routine RxLockEnumerator doit allouer de la mémoire de pool non paginée pour énumérer les verrous. Par conséquent, RxLockEnumerator peut échouer si l’allocation de mémoire échoue.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête rxprocs.h (inclure Rxprocs.h, Mrxfcb.h, Fcb.h)
IRQL <= APC_LEVEL

Voir aussi

The FCB Structure

The SRV_OPEN Structure