RxCreateSrvCall function (fcb.h)

Article
02/22/2024

RxCreateSrvCall builds a SRV_CALL structure and inserts the name into the net name table maintained by RDBSS.

Syntax

PSRV_CALL RxCreateSrvCall(
  IN PRX_CONTEXT       RxContext,
  IN PUNICODE_STRING   Name,
  IN PUNICODE_STRING   InnerNamePrefix,
  IN PRX_CONNECTION_ID RxConnectionId
);

Parameters

RxContext

[in] A pointer to the RX_CONTEXT structure containing the IRP describing a create operation.

Name

[in] A pointer to the name to be inserted in the name table.

InnerNamePrefix

A pointer to an optional inner prefix name to be inserted into the name table with the Name.

RxConnectionId

[in] 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 prefix name table.

Return value

RxCreateSrvCall returns a pointer to a newly created SRV_CALL data structure on success or a NULL pointer on failure.

Remarks

The RxCreateSrvCall 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 SRV_CALL 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 RxCreateSrvCall, a lock on the name table associated with the device object member of the RxContext parameter must be acquired in exclusive mode.

RxCreateSrvCall initializes the server call parameters passed in through extended attributes as part of the associated RX_CONTEXT structure. Currently this includes initializing the pPrincipalName member of the SRV_CALL which is passed in by the DFS driver.

Requirements

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