Routine MRxShouldTryToCollapseThisOpen

Article
02/02/2024

La routine MRxShouldTryToCollapseThisOpen est appelée par RDBSS pour demander qu’un mini-redirecteur réseau indique si RDBSS doit essayer de réduire une demande ouverte sur un objet de système de fichiers existant.

Syntaxe

PMRX_CALLDOWN MRxShouldTryToCollapseThisOpen;

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

Paramètres

RxContext [in, out]
Pointeur vers la structure RX_CONTEXT. Ce paramètre contient l’IRP qui demande l’opération.

Valeur retournée

MRxShouldTryToCollapseThisOpen retourne STATUS_SUCCESS en cas de réussite ou une valeur NTSTATUS appropriée, telle que :

Code de retour	Description
STATUS_MORE_PROCESSING_REQUIRED	Un mini-redirecteur réseau retourne cette valeur pour désactiver l’effondrement de cette demande ouverte.

Remarques

MRxShouldTryToCollapseThisOpen est appelé pour déterminer si une demande ouverte ne doit pas être réduite.

Avant d’appeler MRxShouldTryToCollapseThisOpen, RDBSS modifie le membre suivant dans la structure RX_CONTEXT pointée vers le paramètre RxContext :

Le membre pRelevantSrvOpen est défini sur le SRV_OPEN.

L’appel à MRxShouldTryToCollapseThisOpen peut être une demande de notification de modification pour un annuaire. Par conséquent, le mini-redirecteur réseau peut ne pas autoriser l’effondrement des demandes ouvertes afin que la notification de modification fonctionne correctement.

RDBSS interdit l’ouverture de l’effondrement si le membre Create.NtCreateParameters.CreateOptions de la structure RX_CONTEXT a l’option FILE_OPEN_FOR_BACKUP_INTENT ou l’option FILE_DELETE_ON_CLOSE définie.