Funzione RxLockEnumerator (rxprocs.h)

  • Articolo

RxLockEnumerator viene chiamato da un mini-redirector di rete per enumerare i blocchi di file in un cluster di failover.

Sintassi

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

Parametri

[in, out] SrvOpen

Puntatore alla struttura SRV_OPEN sul cluster di failover da enumerare.

[in, out] ContinuationHandle

Puntatore a un handle passato avanti e indietro che rappresenta lo stato dell'enumerazione. Se questo parametro è un puntatore NULL , si tratta dell'inizio di un'enumerazione di blocco.

[out] FileOffset

Puntatore all'offset del file del blocco restituito.

[out] LockRange

Puntatore all'intervallo di blocchi del blocco restituito.

[out] IsLockExclusive

Puntatore a un valore BOOLEAN che indica se il blocco restituito è un blocco esclusivo.

Valore restituito

RxLockEnumerator restituisce TRUE in caso di esito positivo che indica che i dati di blocco restituiti sono validi. La routine RxLockEnumerator restituisce o FALSE in caso di errore quando non vengono trovati dati di blocco o la fine dell'elenco di blocchi è stata raggiunta.

Commenti

RxLockEnumerator viene in genere chiamato da un min-redirector di rete per enumerare i blocchi di file in un cluster di failover. RxLockEnumerator ottiene un blocco per ogni chiamata. quindi il chiamante deve mantenere lo stato di enumerazione internamente. Di conseguenza, un solo processo di enumerazione può essere in corso in qualsiasi momento.

La routine RxLockEnumerator deve allocare memoria del pool non di paging per enumerare i blocchi. Di conseguenza, RxLockEnumerator può avere esito negativo se l'allocazione della memoria ha esito negativo.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione rxprocs.h (include Rxprocs.h, Mrxfcb.h, Fcb.h)
IRQL <= APC_LEVEL

Vedi anche

Struttura FCB

Struttura SRV_OPEN