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

指向要枚举的 FCB 上的SRV_OPEN结构的指针。

[in, out] ContinuationHandle

指向来回传递的句柄的指针,表示枚举的状态。 如果此参数是 NULL 指针,则这是锁定枚举的开始。

[out] FileOffset

指向返回锁的文件偏移量的指针。

[out] LockRange

指向返回锁的锁范围的指针。

[out] IsLockExclusive

指向布尔值的指针,指示返回的锁是否为独占锁。

返回值

RxLockEnumerator 在成功时返回 true true,指示返回的锁数据有效。 RxLockEnumerator 例程在未找到锁数据或到达锁列表末尾时返回或 FALSE

言论

RxLockEnumerator 通常从网络最小重定向程序调用,以枚举 FCB 上的文件锁。 RxLockEnumerator 每次调用时获取一个锁。 因此,调用方需要在内部保留枚举状态。 因此,随时只能进行一个枚举过程。

RxLockEnumerator 例程需要分配非分页池内存才能枚举锁。 因此,如果内存分配失败,RxLockEnumerator 可能会失败。

要求

要求 价值
目标平台 桌面
标头 rxprocs.h(包括 Rxprocs.h、Mrxfcb.h、Fcb.h)
IRQL <= APC_LEVEL

另请参阅

FCB 结构

SRV_OPEN结构