RxCreateSrvCall 関数 (fcb.h)

[アーティクル]
03/05/2024

RxCreateSrvCall は、SRV_CALL構造体を構築し、RDBSS によって管理されるネット名テーブルに名前を挿入します。

構文

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

パラメーター

RxContext

[入力]作成操作を記述する IRP を含むRX_CONTEXT構造体へのポインター。

Name

[入力]名前テーブルに挿入する名前へのポインター。

InnerNamePrefix

Name を使用して名前テーブルに挿入する、省略可能な内部プレフィックス名へのポインター。

RxConnectionId

[入力]プレフィックス名テーブルに挿入する名前に関連付ける接続 ID へのポインター。このパラメーターには NULL を 指定できます。この場合、プレフィックス名テーブルに挿入された名前に接続 ID は関連付けされません。

戻り値

RxCreateSrvCall は、成功した場合は新しく作成されたSRV_CALLデータ構造へのポインター、または失敗した場合は NULL ポインターを返します。

注釈

RxCreateSrvCall ルーチンは、通常、ネットワークミニリダイレクタードライバーによって直接呼び出されません。 RDBSS は、IRP_MJ_CREATEに対して I/O 要求パケットを受信し、SRV_CALLを作成する必要がある場合に、このルーチンを内部的に呼び出します。この IRP は、通常、ネットワーク共有でファイル作成操作を要求するユーザーモードアプリケーションに応答して RDBSS によって受信されます。また、別のカーネルドライバーがこのような IRP を発行することもできます。

RxCreateSrvCall を呼び出す前に、RxContext パラメーターのデバイスオブジェクトメンバーに関連付けられている名前テーブルのロックを排他モードで取得する必要があります。

RxCreateSrvCall は、関連付けられたRX_CONTEXT構造の一部として、拡張属性を介して渡されるサーバー呼び出しパラメーターを初期化します。現在、これには、DFS ドライバーによって渡されるSRV_CALLの pPrincipalName メンバーの初期化が含まれます。