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 für den FCB, der aufgezählt 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 BOOLESCHEN WERT, der angibt, ob die zurückgegebene Sperre eine exklusive Sperre ist.

Rückgabewert

RxLockEnumerator gibt bei Erfolg TRUE zurück, was angibt, dass die zurückgegebenen Sperrdaten gültig sind. Die RxLockEnumerator-Routine gibt bei Fehlern oder FALSE zurück, wenn keine Sperrdaten gefunden werden 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 bei jedem Aufruf eine Sperre. Daher muss der Aufrufer den Enumerationszustand intern beibehalten. Daher kann jederzeit nur ein Enumerationsprozess ausgeführt werden.

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

Anforderungen

Weitere Informationen

Die FCB-Struktur

Die SRV_OPEN-Struktur