RxLockEnumerator-Funktion (rxprocs.h)
RxLockEnumerator wird von einem Netzwerk-Miniumleitungsmodul aufgerufen, um die Dateisperren auf einem FCB aufzählen zu können.
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 des FCB, die aufgezählt werden soll.
[in, out] ContinuationHandle
Ein Zeiger auf ein Handle, das hin und her übergeben wird, der den Status der Enumeration darstellt. Wenn dieser Parameter ein NULL- Zeiger ist, ist dies der Anfang 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 TRUE- zurück, der angibt, dass die zurückgegebenen Sperrdaten gültig sind. Die RxLockEnumerator Routine gibt fehlerfehler zurück oder, wenn keine Sperrdaten gefunden werden oder das Ende der Liste der Sperren erreicht wurde.
Bemerkungen
RxLockEnumerator- wird normalerweise von einem Netzwerk-Min-Redirector aufgerufen, um die Dateisperren auf einem FCB aufzählen zu können. RxLockEnumerator erhält für jeden Anruf eine Sperre. daher muss der Aufrufer den Enumerationszustand intern beibehalten. Daher kann immer nur ein Enumerationsprozess ausgeführt werden.
Die RxLockEnumerator- Routine muss nicht ausgelagerten Poolspeicher zuweisen, um Sperren auflisten zu können. Folglich kann RxLockEnumerator fehlschlagen, wenn die Speicherzuweisung fehlschlägt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | rxprocs.h (einschließlich Rxprocs.h, Mrxfcb.h, Fcb.h) |
| IRQL- | <= APC_LEVEL |