Compartir a través de

Función RxCeBuildConnection (rxce.h)

  • Artículo

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. En la salida 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 si se realiza correctamente 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 memoria de grupo no paginada necesaria para esta rutina.
STATUS_INVALID_PARAMETER
 Uno de los parámetros pasados a esta rutina no era válido.

Comentarios

Se debe llamar a RxCeBuildConnection en el contexto de un subproceso de trabajo del sistema.

Cuando RxCeBuildConnection se realiza correctamente, los miembros de datos de la estructura RXCE_CONNECTION señalados por el parámetro pConnection y los miembros de datos de la estructura RXCE_VC a la que apunta 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 Value
Plataforma de destino Escritorio
Encabezado rxce.h (incluir Rxce.h)
IRQL <= APC_LEVEL

Consulte también

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION