RxCreateSrvCall 函式 (fcb.h)

RxCreateSrvCall 會建置SRV_CALL結構,並將名稱插入 RDBSS 維護的 net name 資料表中。

語法

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

參數

[in] RxContext

包含描述建立作業之 IRP 之RX_CONTEXT結構的指標。

[in] Name

要插入名稱資料表中名稱的指標。

InnerNamePrefix

[in] RxConnectionId

要與前置詞名稱資料表中插入之名稱相關聯的連接識別碼指標。 此參數可以是 Null ,在此情況下,沒有任何連接識別碼與前置詞名稱資料表中插入的名稱相關聯。

傳回值

RxCreateSrvCall會在成功或失敗時傳回新建立SRV_CALL資料結構的指標。

備註

網路迷你重新導向器驅動程式通常不會直接呼叫 RxCreateSrvCall 常式。 當收到 I/O 要求封包以供IRP_MJ_CREATE且需要建立SRV_CALL時,RDBSS 會在內部呼叫此常式。 RDBSS 通常會收到此 IRP,以回應要求網路共用上檔案建立作業的使用者模式應用程式。 另一個核心驅動程式也可以發出這類 IRP。

呼叫 RxCreateSrvCall之前,必須以獨佔模式取得與 RxCoNtext 參數之裝置物件成員相關聯的名稱資料表鎖定。

RxCreateSrvCall 會將透過擴充屬性傳入的伺服器呼叫參數初始化為相關聯RX_CONTEXT結構的一部分。 目前這包括初始化 DFS 驅動程式傳入之SRV_CALL的 pPrincipalName 成員。

規格需求

   
目標平臺 桌面
標頭 fcb.h (包括 Rxcontx.h、Mrxfcb.h、Prefix.h、Fcb.h)
IRQL <= APC_LEVEL

另請參閱

RX_CONTEXT

RxCreateNetFcb

RxCreateNetFobx

RxCreateNetRoot

RxCreateSrvOpen

RxCreateVNetRoot

RxDereference

RxFinalizeConnection

RxFinalizeNetFcb

RxFinalizeNetFobx

RxFinalizeNetRoot

RxFinalizeSrvCall

RxFinalizeSrvOpen

RxFinalizeVNetRoot

RxFinishFcbInitialization

RxForceFinalizeAllVNetRoots

RxReference

RxSetSrvCallDomainName

RxpDereferenceNetFcb

RxpReferenceNetFcb

SRV_CALL 結構