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 no FCB a ser enumerado.
[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.
Retornar valor
RxLockEnumerator retorna TRUE em caso de ê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.
Comentários
O RxLockEnumerator normalmente é chamado de um min-redirector de rede para enumerar os bloqueios de arquivo em uma 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 paginado para enumerar bloqueios. Consequentemente, o RxLockEnumerator poderá falhar se a alocação de memória falhar.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | rxprocs.h (inclua Rxprocs.h, Mrxfcb.h, Fcb.h) |
| IRQL | <= APC_LEVEL |