Função RxCeBuildTransport (rxce.h)

  • Artigo

RxCeBuildTransport associa um objeto de transporte RDBSS a um nome de transporte especificado.

Sintaxe

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

Parâmetros

pRxCeTransport

Na entrada, esse parâmetro contém um ponteiro para um transporte RDBSS não inicializado ao qual esse nome de transporte deve ser associado. Na saída quando essa chamada for bem-sucedida, o transporte será associado ao nome do transporte especificado e o transporte será inicializado corretamente.

[in] pTransportName

Um ponteiro para a cadeia de caracteres de associação Unicode para o transporte desejado.

[in] QualityOfService

A qualidade do serviço desejada do transporte.

Retornar valor

RxCeBuildTransport retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro em caso de falha:

Código de retorno Descrição
STATUS_INSUFFICIENT_RESOURCES
 Falha na alocação de memória de pool nãopagado necessária para essa rotina.
STATUS_INVALID_PARAMETER
 Um dos parâmetros passados para essa rotina era inválido.

Comentários

Quando RxCeBuildTransport for bem-sucedido, os membros de dados na estrutura RXCE_TRANSPORT apontada pelo parâmetro pTransport serão inicializados corretamente e o transporte RDBSS será associado ao transporte TDI especificado.

As rotinas do mecanismo de conexão no RDBSS não participam da computação da qualidade do serviço. O RDBSS essencialmente usa o parâmetro QualityOfService como um número mágico que é passado para o provedor de transporte subjacente.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho rxce.h (include Rxce.h)
IRQL <= APC_LEVEL

Confira também

RxCeTearDownTransport