Функция RxCeBuildConnection (rxce.h)

Статья
02/07/2025

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 успешно, элементы данных в структуре RXCE_CONNECTION, на которые указывает параметр pConnection и члены данных в структуре RXCE_VC, на которые указывает параметр pVc, будут правильно инициализированы и виртуальный канал будет связан с подключением.

RXCE_CONNECTION_INFORMATION — это типдф для структуры TDI_CONNECTION_INFORMATION.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	rxce.h (include Rxce.h)
IRQL	<= APC_LEVEL

См. также

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION

Поделиться через