Função RxCeBuildConnection (rxce.h)

  • Artigo

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 recebe 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 for bem-sucedida, o circuito virtual será associado à conexão e o circuito virtual será inicializado corretamente.

Retornar valor

RxCeBuildConnection 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

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

Quando RxCeBuildConnection for bem-sucedido, os membros de dados na estrutura RXCE_CONNECTION apontada 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
Plataforma de Destino Área de Trabalho
Cabeçalho rxce.h (include Rxce.h)
IRQL <= APC_LEVEL

Confira também

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION