Função RxCeBuildAddress (rxce.h)

Artigo
02/07/2025

RxCeBuildAddress associa um endereço de transporte a uma associação de transporte.

Sintaxe

NTSTATUS RxCeBuildAddress(
  [in, out] IN OUT PRXCE_ADDRESS           pAddress,
  [in]      IN PRXCE_TRANSPORT             pTransport,
  [in]      IN PTRANSPORT_ADDRESS          pTransportAddress,
  [in]      IN PRXCE_ADDRESS_EVENT_HANDLER pHandler,
  [in]      IN PVOID                       pEventContext
);

Parâmetros

[in, out] pAddress

Na entrada, esse parâmetro contém um ponteiro para uma estrutura de endereços do mecanismo de conexão RDBSS não inicializada. Na saída quando essa chamada for bem-sucedida, os membros de dados na estrutura RXCE_ADDRESS serão inicializados corretamente.

[in] pTransport

Um ponteiro para o transporte ao qual esse endereço deve ser associado.

[in] pTransportAddress

Um ponteiro para o endereço de transporte a ser associado à associação.

[in] pHandler

Um ponteiro para o manipulador de eventos associado ao registro.

[in] pEventContext

Um ponteiro para o parâmetro de contexto a ser passado de volta para o manipulador de eventos.

Valor de retorno

RxCeBuildAddress 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 RxCeBuildAddress era inválido.

Observações

Quando RxCeBuildAddress for bem-sucedido, os membros de dados na estrutura de RXCE_ADDRESS apontados pelo parâmetro pAddress serão inicializados corretamente.

Requisitos

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

Consulte também

RxCeTearDownAddress

Compartilhar via