Função RxAcquireSharedFcbResourceInMRxEx (mrxfcb.h)

RxAcquireSharedFcbResourceInMRxEx adquire o recurso FCB para um driver de minidiretório de rede no modo compartilhado. Essa rotina aguardará que o recurso fcb seja gratuito se ele tiver sido adquirido exclusivamente anteriormente e não retornará o controle até que o recurso compartilhado seja adquirido.

Sintaxe

NTSTATUS RxAcquireSharedFcbResourceInMRxEx(
  [in] IN PRX_CONTEXT pRxContext,
       PMRX_FCB       Fcb
);

Parâmetros

[in] pRxContext

Um ponteiro para o RX_CONTEXT. Esse parâmetro fornece o contexto da operação para tratamento especial pelo acompanhamento interno do RDBSS se esse recurso estiver habilitado.

Fcb

Um ponteiro para o FCB. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

RxAcquireSharedFcbResourceInMRxEx retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro em caso de falha:

Código de retorno Descrição
STATUS_LOCK_NOT_GRANTED
O recurso FCB não foi adquirido.
STATUS_CANCELLED
O RX_CONTEXT associado ao FCB foi cancelado.

Comentários

Os recursos de sincronização de interesse para um driver de minidiretório de rede são associados principalmente ao FCB. Há um recurso de E/S de paginação e um recurso regular. O recurso de E/S de paginação é gerenciado internamente pelo RDBSS. O único recurso acessível a um driver de minidiretório de rede é o recurso regular que deve ser acessado usando RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx ou RxAcquireSharedFcbResourceInMRx, dependendo do modo adquirido desejado.

RxAcquireSharedFcbResourceInMRxEx aguardará que o recurso FCB seja gratuito se ele tiver sido adquirido exclusivamente anteriormente e não retornará o controle até que o recurso compartilhado seja adquirido. Essa rotina adquire o recurso FCB mesmo que o RX_CONTEXT associado a esse FCB tenha sido cancelado.

Um recurso fcb adquirido com RxAcquireSharedFcbResourceInMRxEx deve ser liberado chamando RxReleaseFcbResourceInMRx ou RxReleaseFcbResourceForThreadInMRx.

Requisitos

Requisito Valor
Cliente mínimo com suporte A rotina RxAcquireSharedFcbResourceInMRxEx só está disponível no Windows Server 2003 Service Pack 1 e posterior.
Plataforma de Destino Área de Trabalho
Cabeçalho mrxfcb.h (inclua Mrxfcb.h)
IRQL <= APC_LEVEL

Confira também

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx