RxLockEnumerator, fonction (rxprocs.h)

RxLockEnumerator est appelé à partir d’un mini-redirecteur réseau pour énumérer les verrous de fichier sur un 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é en arrière 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 verrou.

[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 de retour

RxLockEnumerator retourne TRUE sur la 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 FCB. RxLockEnumerator obtient un verrou sur chaque appel. ainsi, l’appelant doit 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 la mémoire de pool non pagenée pour énumérer les verrous. Par conséquent, RxLockEnumerator peut échouer si l’allocation de mémoire échoue.

Configuration requise

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

Voir aussi

The FCB Structure

The SRV_OPEN Structure