Funzione RxLockEnumerator (rxprocs.h)
RxLockEnumerator viene chiamato da un mini-reindirizzamento di rete per enumerare i blocchi di file in un fcB.
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 di SRV_OPEN nel fcB da enumerare.
[in, out] ContinuationHandle
Puntatore a un handle passato indietro 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 normalmente chiamato da un min-redirector di rete per enumerare i blocchi di file in un fcB. RxLockEnumerator ottiene un blocco in 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 a pagina 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 |