Função RxLockEnumerator (rxprocs.h)
RxLockEnumerator é chamado de um minidiretório de rede para enumerar os bloqueios de arquivo em um FCB.
Sintaxe
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
);
Parâmetros
[in, out] SrvOpen
Um ponteiro para a estrutura SRV_OPEN na FCB a ser enumerada.
[in, out] ContinuationHandle
Um ponteiro para um identificador passado para frente e para trás que representa o estado da enumeração. Se esse parâmetro for um ponteiro NULL, esse será o início de uma enumeração de bloqueio.
[out] FileOffset
Um ponteiro para o deslocamento de arquivo do bloqueio retornado.
[out] LockRange
Um ponteiro para o intervalo de bloqueio do bloqueio retornado.
[out] IsLockExclusive
Um ponteiro para um BOOLEAN que indica se o bloqueio retornado é um bloqueio exclusivo.
Valor de retorno
RxLockEnumerator retorna TRUE com êxito indicando que os dados de bloqueio retornados são válidos. A rotina RxLockEnumerator retorna ou FALSE em caso de falha quando nenhum dado de bloqueio é encontrado ou o fim da lista de bloqueios foi atingido.
Observações
RxLockEnumerator normalmente é chamado de um min-redirector de rede para enumerar os bloqueios de arquivo em um FCB. RxLockEnumerator obtém um bloqueio em cada chamada. portanto, o chamador precisa manter o estado de enumeração internamente. Como resultado, apenas um processo de enumeração pode estar em andamento a qualquer momento.
A rotina RxLockEnumerator precisa alocar memória de pool não paged para enumerar bloqueios. Consequentemente, RxLockEnumerator poderá falhar se a alocação de memória falhar.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | rxprocs.h (include Rxprocs.h, Mrxfcb.h, Fcb.h) |
| IRQL | <= APC_LEVEL |