RxCeBuildVC 関数 (rxce.h)

RxCeBuildVC は、指定された RDBSS 接続に仮想回線を追加します。

構文

NTSTATUS RxCeBuildVC(
  [in, out] IN OUT PRXCE_VC     pVc,
            IN PRXCE_CONNECTION Connection
);

[in, out] pVc

入力時に、このパラメーターには、初期化されていない仮想回線のハンドルへのポインターが含まれます。この呼び出しが成功した場合の出力では、仮想回線は指定された接続に関連付けられ、仮想回線の状態はアクティブとして初期化されます。

Connection

仮想回線を追加する接続へのポインター。

RxCeBuildVC は、成功した場合はSTATUS_SUCCESSを返し、失敗した場合は次のいずれかのエラーコードを返します。

リターンコード	説明
STATUS_INSUFFICIENT_RESOURCES	このルーチンで必要な非ページプールメモリの割り当てに失敗しました。
STATUS_INVALID_PARAMETER	このルーチンに渡されたパラメーターの 1 つが無効でした。

RxCeBuildVC が成功すると、pVC パラメーターによって指されるRXCE_VC構造体のデータメンバーが適切に初期化され、仮想回線が指定された RDBSS 接続に追加されます。