Función RxCeBuildTransport (rxce.h)

  • Artículo

RxCeBuildTransport enlaza un objeto de transporte RDBSS a un nombre de transporte especificado.

Sintaxis

NTSTATUS RxCeBuildTransport(
       IN PRXCE_TRANSPORT pRxCeTransport,
  [in] IN PUNICODE_STRING pTransportName,
  [in] IN ULONG           QualityOfService
);

Parámetros

pRxCeTransport

En la entrada, este parámetro contiene un puntero a un transporte RDBSS sin inicializar con el que se va a asociar este nombre de transporte. Cuando esta llamada se realiza correctamente, el transporte se asocia con el nombre de transporte especificado y el transporte se inicializa correctamente.

[in] pTransportName

Puntero a la cadena de enlace Unicode para el transporte deseado.

[in] QualityOfService

Calidad de servicio deseada desde el transporte.

Valor devuelto

RxCeBuildTransport devuelve STATUS_SUCCESS 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

Cuando RxCeBuildTransport se realiza correctamente, los miembros de datos de la estructura RXCE_TRANSPORT a la que apunta el parámetro pTransport se inicializarán correctamente y el transporte RDBSS se enlazará al transporte TDI especificado.

Las rutinas del motor de conexión en RDBSS no participan en el cálculo de la calidad del servicio. RDBSS usa básicamente el parámetro QualityOfService como un número mágico que se pasa al proveedor de transporte subyacente.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado rxce.h (incluir Rxce.h)
IRQL <= APC_LEVEL

Consulte también

RxCeTearDownTransport