Rotina MRxShouldTryToCollapseThisOpen

Artigo
02/02/2024

A rotina MRxShouldTryToCollapseThisOpen é chamada pelo RDBSS para solicitar que um minidiretório de rede indique se o RDBSS deve tentar recolher uma solicitação aberta em um objeto do sistema de arquivos existente.

Sintaxe

PMRX_CALLDOWN MRxShouldTryToCollapseThisOpen;

NTSTATUS MRxShouldTryToCollapseThisOpen(
  _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

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

Código de retorno	Descrição
STATUS_MORE_PROCESSING_REQUIRED	Um minidiretório de rede retorna esse valor para desabilitar o recolhimento dessa solicitação aberta.

Comentários

MRxShouldTryToCollapseThisOpen é chamado para determinar se uma solicitação aberta não deve ser recolhida.

Antes de chamar MRxShouldTryToCollapseThisOpen, o RDBSS modifica o seguinte membro na estrutura RX_CONTEXT apontada pelo parâmetro RxContext :

O membro pRelevantSrvOpen é definido como o SRV_OPEN.

A chamada para MRxShouldTryToCollapseThisOpen pode ser uma solicitação de notificação de alteração para um diretório. Portanto, o minidiretório de rede pode não permitir o recolhimento de solicitações abertas para que a notificação de alteração funcione corretamente.

O RDBSS não permite o recolhimento será aberto se o membro Create.NtCreateParameters.CreateOptions da estrutura RX_CONTEXT tiver a opção FILE_OPEN_FOR_BACKUP_INTENT ou a opção FILE_DELETE_ON_CLOSE definida.