次の方法で共有

RxCeBuildConnection 関数 (rxce.h)

  • [アーティクル]

RxCeBuildConnection は、ローカル RDBSS 接続アドレスと指定されたリモート アドレスの間の接続を確立します。

構文

NTSTATUS RxCeBuildConnection(
            IN PRXCE_ADDRESS                  pLocalAddress,
  [in]      IN PRXCE_CONNECTION_INFORMATION   pConnectionInformation,
  [in]      IN PRXCE_CONNECTION_EVENT_HANDLER pHandler,
  [in]      IN PVOID                          pEventContext,
  [in, out] IN OUT PRXCE_CONNECTION           pConnection,
  [in, out] IN OUT PRXCE_VC                   pVc
);

パラメーター

pLocalAddress

ローカル RDBSS 接続エンジン アドレスへのポインター。

[in] pConnectionInformation

リモート アドレスを指定する接続情報へのポインター。

[in] pHandler

処理用のイベント ハンドラーへのポインターは、通知を受け取ります。

[in] pEventContext

イベント ハンドラーに渡され、表示に使用されるコンテキスト パラメーターへのポインター。

[in, out] pConnection

入力時に、このパラメーターには初期化されていない RDBSS 接続へのポインターが含まれます。 この呼び出しが成功すると、出力時に接続が正しく初期化されます。

[in, out] pVc

入力時に、このパラメーターには初期化されていない RDBSS 仮想回線へのポインターが含まれます。 この呼び出しが成功した場合の出力では、仮想回線が接続に関連付けられて、仮想回線が適切に初期化されます。

戻り値

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

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

注釈

RxCeBuildConnection は、システム ワーカー スレッドのコンテキストで呼び出す必要があります。

RxCeBuildConnection が成功すると、pConnection パラメーターによって指されるRXCE_CONNECTION構造体のデータ メンバーと、pVc パラメーターによって指されるRXCE_VC構造体のデータ メンバーが適切に初期化され、仮想回線が接続に関連付けられます。

RXCE_CONNECTION_INFORMATION は、 TDI_CONNECTION_INFORMATION 構造体の typedef です。

要件

要件 値
対象プラットフォーム デスクトップ
Header rxce.h (Rxce.h を含む)
IRQL <= APC_LEVEL

こちらもご覧ください

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION