Edit

Share via

RxCeBuildAddress function (rxce.h)

  • Article

RxCeBuildAddress associates a transport address with a transport binding.

Syntax

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
);

Parameters

[in, out] pAddress

On input, this parameter contains a pointer to an uninitialized RDBSS connection engine address structure. On output when this call is successful, the data members in the RXCE_ADDRESS structure will be properly initialized.

[in] pTransport

A pointer to the transport with which this address is to be associated.

[in] pTransportAddress

A pointer to the transport address to be associated with the binding.

[in] pHandler

A pointer to the event handler associated with the registration.

[in] pEventContext

A pointer to the context parameter to be passed back to the event handler.

Return value

RxCeBuildAddress returns STATUS_SUCCESS on success or one of the following error codes on failure:

Return code Description
STATUS_INSUFFICIENT_RESOURCES
 The allocation of nonpaged pool memory needed by this routine failed.
STATUS_INVALID_PARAMETER
 One of the parameters passed to RxCeBuildAddress was invalid.

Remarks

When RxCeBuildAddress is successful, the data members in the RXCE_ADDRESS structure pointed to by the pAddress parameter will be properly initialized.

Requirements

Requirement Value
Target Platform Desktop
Header rxce.h (include Rxce.h)
IRQL <= APC_LEVEL

See also

RxCeTearDownAddress