Função RxCeBuildTransport (rxce.h)
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 com o qual esse nome de transporte deve ser associado. Na saída quando essa chamada é bem-sucedida, o transporte é associado ao nome de transporte especificado e o transporte é 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 desejado do transporte.
Valor de retorno
RxCeBuildTransport retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro sobre falha:
| Código de retorno | Descrição |
|---|---|
|
Falha na alocação de memória de pool nãopagada necessária para essa rotina. |
|
Um dos parâmetros passados para essa rotina era inválido. |
Observações
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 usa essencialmente o parâmetro QualityOfService como um número mágico que é passado para o provedor de transporte subjacente.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | rxce.h (inclua Rxce.h) |
| IRQL | <= APC_LEVEL |