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

RxLockEnumerator retourne TRUE en cas de réussite indiquant que les données de verrou retournées sont valides. L'RxLockEnumerator routine retourne ou FAUX 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. 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.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête rxprocs.h (include Rxprocs.h, Mrxfcb.h, Fcb.h)
IRQL <= APC_LEVEL

Voir aussi

La structure FCB

La structure SRV_OPEN