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

Vedi anche

Struttura FCB

Struttura SRV_OPEN