Rotina MRxCollapseOpen

Artigo
02/12/2024

A rotina MRxCollapseOpen é chamada pelo RDBSS para solicitar que o minidiretório de rede recolha uma solicitação do sistema de arquivos aberto em uma estrutura de SRV_OPEN existente.

Sintaxe

PMRX_CALLDOWN MRxCollapseOpen;

NTSTATUS MRxCollapseOpen(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Parâmetros

RxContext [in, out]
Um ponteiro para a estrutura RX_CONTEXT. Esse parâmetro contém o IRP que está solicitando a operação.

Retornar valor

MRxCollapseOpen retorna STATUS_SUCCESS com êxito ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno	Descrição
STATUS_INSUFFICIENT_RESOURCES	Não havia recursos suficientes para concluir a operação.

Comentários

MRxCollapseOpen é chamado pelo RDBSS para recolher uma estrutura de SRV_OPEN localmente. O minidiretório de rede é consultado para determinar se um colapso é possível, portanto, não há motivo para chamar o minidiretório de rede duas vezes. Se o minidiretório de rede decidir recolher a estrutura SRV_OPEN, ele fará isso e passará um status retornável. Um valor retornado de STATUS_SUCCESS é um valor retornado de encerramento. Um valor retornado diferente, por exemplo, STATUS_MORE_PROCESSING_REQUIRED, é considerado um valor retornado que não termina.

Antes de chamar MRxCollapseOpen, o RDBSS modifica os seguintes membros na estrutura RX_CONTEXT apontada pelo parâmetro RxContext :

pRelevantSrvOpen é definido como a estrutura SRV_OPEN a ser recolhida.

Create.pSrvCall é definido como a estrutura SRV_CALL associada ao SRV_OPEN.

Se o minidiretório de rede decidir recolher a estrutura SRV_OPEN, o membro SrvOpen da estrutura RX_CONTEXT deverá ser definido como a estrutura de SRV_OPEN recolhida.