Функция RxLockEnumerator (rxprocs.h)

Статья
08/07/2023

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 в перечисляемом fcb.

[in, out] ContinuationHandle

Указатель на дескриптор, передаваемый взад и вперед, представляющий состояние перечисления. Если этот параметр является указателем NULL , то это начало перечисления блокировки.

[out] FileOffset

Указатель на смещение файла возвращенной блокировки.

[out] LockRange

Указатель на диапазон блокировки возвращенной блокировки.

[out] IsLockExclusive

Указатель на BOOLEAN, указывающий, является ли возвращенная блокировка монопольной.

Возвращаемое значение

RxLockEnumerator возвращает значение TRUE при успешном выполнении, указывая, что возвращенные данные блокировки являются допустимыми. Подпрограмма RxLockEnumerator возвращает значение FALSE при сбое, если данные блокировки не найдены или достигнут конец списка блокировок.

RxLockEnumerator обычно вызывается из сетевого мин-перенаправителя для перечисления блокировок файлов в FCB. RxLockEnumerator получает одну блокировку при каждом вызове. поэтому вызывающий объект должен поддерживать состояние перечисления внутри организации. В результате в любой момент может выполняться только один процесс перечисления.

Подпрограмме RxLockEnumerator необходимо выделить нестраничную память пула для перечисления блокировок. Следовательно, RxLockEnumerator может завершиться сбоем при сбое выделения памяти.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	rxprocs.h (включая Rxprocs.h, Mrxfcb.h, Fcb.h)
IRQL	<= APC_LEVEL

См. также раздел

Структура FCB

Структура SRV_OPEN

Share via