PMRX_GET_CONNECTION_ID callback function (mrx.h)
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) |