PMRX_GET_CONNECTION_ID callback function (mrx.h)

Article
10/12/2023

TheMRxGetConnectionId routine is called by RDBSS to request that a network mini-redirector return a connection ID, which can be used for handling multiple sessions.

Syntax

PMRX_GET_CONNECTION_ID PmrxGetConnectionId;

NTSTATUS PmrxGetConnectionId(
  IN OUT PRX_CONTEXT RxContext,
  IN OUT PRX_CONNECTION_ID UniqueId
)
{...}

Parameters

RxContext

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

UniqueId

[in, out] A pointer to the connection ID when the routine returns.

Return value

MRxGetConnectionId returns STATUS_SUCCESS on success or an appropriate NTSTATUS value, such as the following:

Return code	Description
STATUS_NOT_IMPLEMENTED	This routine is not implemented.

Remarks

MRxGetConnectionId is called by RDBSS when trying to find or construct a V_NET_ROOT structure.

If connection IDs are supported by the network mini-redirector, then the returned connection ID is appended to the NET_ROOT structure name stored in the NetName table used by RDBSS for storing network names. RDBSS considers the connection ID as an opaque blob, and does a byte-by-byte comparison of the connection ID blob while looking up the NetName table for a given name with a connection ID.

Requirements

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