MRxTruncate routine

Article
03/14/2023

The MRxTruncate routine is called by RDBSS to request that a network mini-redirector truncate the contents of a file system object.

Syntax

PMRX_CALLDOWN MRxTruncate;

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

Parameters

RxContext [in, out]
A pointer to the RX_CONTEXT structure. This parameter contains the IRP that is requesting the operation.

Return value

MRxTruncate returns STATUS_SUCCESS on success or an appropriate NTSTATUS value, such as one of the following:

Return code	Description
STATUS_NOT_IMPLEMENTED	This routine is not implemented.

Remarks

MRxTruncate is called as part of cleanup operations if both of the following conditions are true:

The file object corresponds to a disk file or directory
This is the last cleanup call and the file object was marked for truncation.

The file object is marked for truncation if the fcbstate member of the FCB structure has the FCB_STATE_TRUNCATE_ON_CLOSE bit set. RDBSS will uninitialize the cache map at some later time.

A call to MRxTruncate will be followed by a call to MRxCleanupFobx as part of the cleanup operation.

RDBSS ignores the return value from MRxTruncate.

Requirements

Target platform	Desktop
Header	Mrx.h (include Mrx.h)