RxCreateVNetRoot function (fcb.h)

Article
03/15/2022

RxCreateVNetRoot allocates and initializes a NET_ROOT structure and inserts the name into the net name table on the associated device object.

Syntax

PV_NET_ROOT RxCreateVNetRoot(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PNET_ROOT         NetRoot,
  [in] IN PUNICODE_STRING   CanonicalName,
  [in] IN PUNICODE_STRING   LocalNetRootName,
  [in] IN PUNICODE_STRING   FilePath,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

Parameters

[in] RxContext

A pointer to the RDBSS RX_CONTEXT containing the IRP describing a create operation.

[in] NetRoot

A pointer to the associated NET_ROOT structure.

[in] CanonicalName

A pointer to the canonical name to be inserted in the name table.

[in] LocalNetRootName

A pointer to the local NET_ROOT name without the prefix name.

[in] FilePath

A pointer to a file pathname. This parameter is not currently used and can be NULL.

[in] RxConnectionId

A pointer to the connection ID to be associated with the name to be inserted in the prefix name table. This parameter can be NULL in which case no connection ID will be associated with the name inserted in the name table.

Return value

RxCreateVNetRoot returns a pointer to a newly created V_NET_ROOT data structure on success or a NULL pointer on failure.

Remarks

The RxCreateVNetRoot routine is not normally called by network mini-redirector drivers directly. RDBSS calls this routine internally when an I/O request packet is received for IRP_MJ_CREATE and a V_NET_ROOT needs to be created. This IRP is normally received by RDBSS in response to a user-mode application requesting a file create operation on a network share. It is also possible for another kernel driver to issue such an IRP.

Before calling RxCreateVNetRoot, a lock on the name table associated with the device object member of the RxContext parameter must be acquired in exclusive mode.

RxCreateVNetRoot sets a variety of security context parameters on the V_NET_ROOT structure based on parameters from the RX_CONTEXT. These parameters include the following: LogonId, SessionId, pUserName, pUserDomainName, pPassword, and Flags.

Requirements

Requirement	Value
Target Platform	Desktop
Header	fcb.h (include Rxcontx.h, Mrxfcb.h, Prefix.h, Struchdr.h, Fcb.h)
IRQL	<= APC_LEVEL