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

Confira também

A estrutura FCB

A estrutura SRV_OPEN