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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть rxce.h (включая Rxce.h)
IRQL <= APC_LEVEL

См. также раздел

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION