Función RxCeBuildConnection (rxce.h)

RxCeBuildConnection establece una conexión entre una dirección de conexión RDBSS local y una dirección remota determinada.

Sintaxis

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
);

Parámetros

pLocalAddress

Puntero a la dirección del motor de conexión RDBSS local.

[in] pConnectionInformation

Puntero a la información de conexión que especifica la dirección remota.

[in] pHandler

Puntero al controlador de eventos para procesar indicaciones de recepción.

[in] pEventContext

Puntero al parámetro de contexto que se va a devolver al controlador de eventos y se usa para indicaciones.

[in, out] pConnection

En la entrada, este parámetro contiene un puntero a una conexión RDBSS sin inicializar. Cuando esta llamada se realiza correctamente, la conexión se inicializa correctamente.

[in, out] pVc

En la entrada, este parámetro contiene un puntero a un circuito virtual RDBSS sin inicializar. Cuando esta llamada se realiza correctamente, el circuito virtual está asociado a la conexión y el circuito virtual se inicializa correctamente.

Valor devuelto

RxCeBuildConnection devuelve STATUS_SUCCESS correcto o uno de los siguientes códigos de error en caso de error:

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	Error en la asignación de la memoria del grupo no paginada necesaria para esta rutina.
STATUS_INVALID_PARAMETER	Uno de los parámetros pasados a esta rutina no era válido.

Observaciones

rxCeBuildConnection debe llamarse en el contexto de un subproceso de trabajo del sistema.

Cuando RxCeBuildConnection se realiza correctamente, los miembros de datos de la estructura RXCE_CONNECTION a la que apunta el parámetro pConnection y los miembros de datos de la estructura de RXCE_VC apuntado por el parámetro pVc se inicializarán correctamente y el circuito virtual se asociará a la conexión.

RXCE_CONNECTION_INFORMATION es una definición de tipo para una estructura de TDI_CONNECTION_INFORMATION.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	rxce.h (include Rxce.h)
irQL	<= APC_LEVEL

Consulte también

rxCeTearDownConnection

TDI_CONNECTION_INFORMATION