PMRX_PREPARSE_NAME callback function (mrx.h)

Article
02/22/2024

The MRxPreparseName routine is called by RDBSS to give a network mini-redirector the opportunity to preparse a name.

Syntax

PMRX_PREPARSE_NAME PmrxPreparseName;

NTSTATUS PmrxPreparseName(
  IN OUT PRX_CONTEXT RxContext,
  IN PUNICODE_STRING Name
)
{...}

Parameters

RxContext

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

Name

[in] A pointer to a Unicode string that contains the name string.

Return value

MRxPreparseName returns STATUS_SUCCESS on success.

Remarks

MRxPreparseName is called by RDBSS after parsing a name to give a network mini-redirector a final opportunity to preparse the name.

RDBSS tries to convert the name to its canonical form, removing a dot (".") and two dots (".."), before calling MRxPreparseName. RDBSS will also parse the format used by NTFS streams.

RDBSS ignores the return value from MRxPreparseName.

Requirements

Requirement	Value
Target Platform	Desktop
Header	mrx.h (include Mrx.h)