RxLockEnumerator-Funktion (rxprocs.h)

RxLockEnumerator wird von einem Netzwerk-Mini-Redirector aufgerufen, um die Dateisperren für einen FCB aufzulisten.

Syntax

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
);

Parameter

[in, out] SrvOpen

Ein Zeiger auf die SRV_OPEN Struktur auf dem FCB, die aufgelistet werden soll.

[in, out] ContinuationHandle

Ein Zeiger auf ein Handle, das hin und her übergeben wird, der den Zustand der Enumeration darstellt. Wenn es sich bei diesem Parameter um einen NULL-Zeiger handelt, ist dies der Beginn einer Sperraufzählung.

[out] FileOffset

Ein Zeiger auf den Dateioffset der zurückgegebenen Sperre.

[out] LockRange

Ein Zeiger auf den Sperrbereich der zurückgegebenen Sperre.

[out] IsLockExclusive

Ein Zeiger auf einen BOOLEAN, der angibt, ob es sich bei der zurückgegebenen Sperre um eine exklusive Sperre handelt.

Rückgabewert

RxLockEnumerator gibt bei Erfolg TRUE zurück, was angibt, dass die zurückgegebenen Sperrdaten gültig sind. Die RxLockEnumerator-Routine gibt bei Einem Fehler false zurück, wenn keine Sperrdaten gefunden oder das Ende der Sperrliste erreicht wurde.

Hinweise

RxLockEnumerator wird normalerweise von einem Netzwerk-Min-Redirector aufgerufen, um die Dateisperren für einen FCB aufzulisten. RxLockEnumerator erhält eine Sperre für jeden Aufruf. Daher muss der Aufrufer den Enumerationsstatus intern beibehalten. Daher kann jederzeit nur ein Enumerationsprozess ausgeführt werden.

Die RxLockEnumerator-Routine muss nicht ausgelagerten Poolspeicher zuweisen, um Sperren aufzulisten. Daher kann RxLockEnumerator fehlschlagen, wenn die Speicherzuordnung fehlschlägt.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	rxprocs.h (include Rxprocs.h, Mrxfcb.h, Fcb.h)
IRQL	<= APC_LEVEL

Weitere Informationen

Die FCB-Struktur

Die SRV_OPEN-Struktur