RxCeBuildAddress, fonction (rxce.h)

  • Article

RxCeBuildAddress associe une adresse de transport à une liaison de transport.

Syntaxe

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

Paramètres

[in, out] pAddress

Lors de l’entrée, ce paramètre contient un pointeur vers une structure d’adresse du moteur de connexion RDBSS non initialisée. Lors de la sortie lorsque cet appel réussit, les membres de données dans la structure RXCE_ADDRESS sont correctement initialisés.

[in] pTransport

Pointeur vers le transport auquel cette adresse doit être associée.

[in] pTransportAddress

Pointeur vers l’adresse de transport à associer à la liaison.

[in] pHandler

Pointeur vers le gestionnaire d’événements associé à l’inscription.

[in] pEventContext

Pointeur vers le paramètre de contexte à renvoyer au gestionnaire d’événements.

Valeur retournée

RxCeBuildAddress retourne STATUS_SUCCESS en cas de réussite ou l’un des codes d’erreur suivants en cas d’échec :

Code de retour Description
STATUS_INSUFFICIENT_RESOURCES
 L’allocation de la mémoire du pool non paginé nécessaire à cette routine a échoué.
STATUS_INVALID_PARAMETER
 L’un des paramètres transmis à RxCeBuildAddress n’était pas valide.

Remarques

Lorsque RxCeBuildAddress réussit, les membres de données dans la structure RXCE_ADDRESS pointées par le paramètre pAddress sont correctement initialisés.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête rxce.h (inclure Rxce.h)
IRQL <= APC_LEVEL

Voir aussi

RxCeTearDownAddress