Функция RxLockEnumerator (rxprocs.h)
RxLockEnumerator вызывается из мини-перенаправления сети, чтобы перечислить блокировки файлов в FCB.
Синтаксис
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
);
Параметры
[in, out] SrvOpen
Указатель на структуру SRV_OPEN в ФКБ для перечисления.
[in, out] ContinuationHandle
Указатель на дескриптор, передаваемый назад и вперед, представляющий состояние перечисления. Если этот параметр является указателем NULL, то это начало перечисления блокировки.
[out] FileOffset
Указатель на смещение файла возвращаемой блокировки.
[out] LockRange
Указатель на диапазон блокировки возвращаемой блокировки.
[out] IsLockExclusive
Указатель на boOLEAN, указывающий, является ли возвращенная блокировка монопольной.
Возвращаемое значение
RxLockEnumerator возвращает TRUE при успешном выполнении, указывая, что возвращенные данные блокировки допустимы. Функция RxLockEnumerator возвращает или false при сбое при отсутствии данных блокировки или достижении конца списка блокировок.
Замечания
RxLockEnumerator обычно вызывается из сетевого мин-перенаправления, чтобы перечислить блокировки файлов в FCB. RxLockEnumerator получает одну блокировку для каждого вызова. поэтому вызывающий объект должен внутренне хранить состояние перечисления. В результате в любое время может выполняться только один процесс перечисления.
RxLockEnumerator подпрограмме необходимо выделить нестраничную память пула для перечисления блокировок. Следовательно, RxLockEnumerator может завершиться ошибкой, если выделение памяти завершается ошибкой.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | rxprocs.h (include Rxprocs.h, Mrxfcb.h, Fcb.h) |
| IRQL | <= APC_LEVEL |