Função RxAcquireSharedFcbResourceInMRxEx (mrxfcb.h)

Artigo
02/07/2025

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 foi adquirido exclusivamente anteriormente e não retornará o controle até que o recurso compartilhado tenha sido 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 a FCB. Esse parâmetro é necessário e não pode ser NULL.

Valor de retorno

RxAcquireSharedFcbResourceInMRxEx retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro sobre 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.

Observações

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, RxAcquireExclusiveFcbResourceInMRxExou RxAcquireSharedFcbResourceInMRx, dependendo do modo adquirido desejado.

RxAcquireSharedFcbResourceInMRxEx aguardará que o recurso FCB seja gratuito se ele foi adquirido exclusivamente e não retornará o controle até que o recurso compartilhado seja adquirido. Essa rotina adquire o recurso fcb mesmo que a RX_CONTEXT associada a essa FCB tenha sido cancelada.

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

Requisitos

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

Consulte também

RxAcquireExclusiveFcbResourceInMRx

RxAcquireSharedFcbResourceInMRx

RxReleaseFcbResourceForThreadInMRx

RxReleaseFcbResourceInMRx

Compartilhar via