RxCreateSrvCall 函数（fcb.h）

项目
02/06/2025

RxCreateSrvCall 生成SRV_CALL结构，并将名称插入 RDBSS 维护的 net name 表中。

语法

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

参数

RxContext

[in]指向包含描述创建作的 IRP 的RX_CONTEXT结构的指针。

Name

[in]指向名称表中要插入的名称的指针。

InnerNamePrefix

指向要插入名称表中的可选内部前缀名称的指针，该名称名称。

RxConnectionId

[in]指向要与要插入前缀名称表中的名称关联的连接 ID 的指针。此参数可以 NULL 在这种情况下，不会将连接 ID 与前缀名称表中插入的名称相关联。

返回值

RxCreateSrvCall 在成功时返回指向新创建的SRV_CALL数据结构的指针，或者在失败时返回 NULL 指针。

言论

RxCreateSrvCall 例程通常不是由网络微型重定向程序驱动程序直接调用的。当收到IRP_MJ_CREATE的 I/O 请求数据包，并且需要创建SRV_CALL时，RDBSS 会在内部调用此例程。 RDBSS 通常会接收此 IRP，以响应请求在网络共享上执行文件创建作的用户模式应用程序。另一个内核驱动程序也可以发出此类 IRP。

在调用 RxCreateSrvCall之前，必须以独占模式获取与 RxContext 参数的设备对象成员关联的名称表上的锁。

RxCreateSrvCall 初始化通过扩展属性传入的服务器调用参数，作为关联RX_CONTEXT结构的一部分。目前，这包括初始化 pPrincipalName 由 DFS 驱动程序传入的SRV_CALL的成员。