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 |