Routine MRxTruncate

Article
02/07/2024

La routine MRxTruncate est appelée par RDBSS pour demander qu’un mini-redirecteur réseau tronque le contenu d’un objet de système de fichiers.

Syntaxe

PMRX_CALLDOWN MRxTruncate;

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

MRxTruncate retourne STATUS_SUCCESS en cas de réussite ou une valeur NTSTATUS appropriée, par exemple :

Code de retour	Description
STATUS_NOT_IMPLEMENTED	Cette routine n’est pas implémentée.

Remarques

MRxTruncate est appelé dans le cadre des opérations de nettoyage si les deux conditions suivantes sont remplies :

L’objet file correspond à un fichier de disque ou à un répertoire
Il s’agit du dernier appel de nettoyage et l’objet de fichier a été marqué pour la troncation.

L’objet file est marqué pour la troncation si le membre fcbstate de la structure FCB a le FCB_STATE_TRUNCATE_ON_CLOSE bit défini. RDBSS annulera la initialisation de la carte du cache ultérieurement.

Un appel à MRxTruncate sera suivi d’un appel à MRxCleanupFobx dans le cadre de l’opération de nettoyage.

RDBSS ignore la valeur de retour de MRxTruncate.