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，或在失敗時傳回下列其中一個錯誤碼：

傳回碼 Description
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