共用方式為

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
 傳遞至此例程的其中一個參數無效。

言論

RxCeBuildConnection 應該在系統背景工作線程的內容中呼叫。

RxCeBuildConnection 成功時，pConnection 參數所指向RXCE_CONNECTION結構中的數據成員，且 pVc 參數所指向之RXCE_VC結構中的數據成員將會正確初始化，且虛擬線路將會與聯機相關聯。

RXCE_CONNECTION_INFORMATION 是 TDI_CONNECTION_INFORMATION 結構的 typedef。

要求

要求 價值
目標平臺 桌面
標頭 rxce.h （包括 Rxce.h）
IRQL <= APC_LEVEL

另請參閱

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION