Função RxCeBuildConnection (rxce.h)

Artigo
02/07/2025

RxCeBuildConnection estabelece uma conexão entre um endereço de conexão RDBSS local e um determinado endereço remoto.

Sintaxe

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

Um ponteiro para o endereço do mecanismo de conexão RDBSS local.

[in] pConnectionInformation

Um ponteiro para as informações de conexão que especificam o endereço remoto.

[in] pHandler

Um ponteiro para o manipulador de eventos para processamento receber indicações.

[in] pEventContext

Um ponteiro para o parâmetro de contexto a ser passado de volta para o manipulador de eventos e usado para indicações.

[in, out] pConnection

Na entrada, esse parâmetro contém um ponteiro para uma conexão RDBSS não inicializada. Na saída quando essa chamada for bem-sucedida, a conexão será inicializada corretamente.

[in, out] pVc

Na entrada, esse parâmetro contém um ponteiro para um circuito virtual RDBSS não inicializado. Na saída quando essa chamada é bem-sucedida, o circuito virtual é associado à conexão e o circuito virtual é inicializado corretamente.

Valor de retorno

RxCeBuildConnection retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro sobre falha:

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

Observações

RxCeBuildConnection deve ser chamado no contexto de um thread de trabalho do sistema.

Quando RxCeBuildConnection for bem-sucedida, os membros de dados na estrutura de RXCE_CONNECTION apontados pelo parâmetro pConnection e os membros de dados na estrutura RXCE_VC apontada pelo parâmetro pVc serão inicializados corretamente e o circuito virtual será associado à conexão.

RXCE_CONNECTION_INFORMATION é um typedef para uma estrutura TDI_CONNECTION_INFORMATION.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	rxce.h (inclua Rxce.h)
IRQL	<= APC_LEVEL

Consulte também

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION

Compartilhar via