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 do 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 retornado

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 final 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 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 pode falhar se a alocação de memória falhar.

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho rxprocs.h (include Rxprocs.h, Mrxfcb.h, Fcb.h)
IRQL <= APC_LEVEL

Confira também

A estrutura FCB

A estrutura SRV_OPEN