Fonction RxCeBuildConnection (rxce.h)

Article
02/07/2025

RxCeBuildConnection établit une connexion entre une adresse de connexion RDBSS locale et une adresse distante donnée.

Syntaxe

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

Paramètres

pLocalAddress

Pointeur vers l’adresse du moteur de connexion RDBSS local.

[in] pConnectionInformation

Pointeur vers les informations de connexion qui spécifient l’adresse distante.

[in] pHandler

Pointeur vers le gestionnaire d’événements pour le traitement des indications de réception.

[in] pEventContext

Pointeur vers le paramètre de contexte à passer au gestionnaire d’événements et utilisé pour les indications.

[in, out] pConnection

Lors de l’entrée, ce paramètre contient un pointeur vers une connexion RDBSS non initialisée. Lors de la sortie lorsque cet appel réussit, la connexion est correctement initialisée.

[in, out] pVc

Lors de l’entrée, ce paramètre contient un pointeur vers un circuit virtuel RDBSS non initialisé. En sortie lorsque cet appel réussit, le circuit virtuel est associé à la connexion et le circuit virtuel est correctement initialisé.

Valeur de retour

RxCeBuildConnection retourne STATUS_SUCCESS sur la réussite ou l’un des codes d’erreur suivants en cas d’échec :

Retourner le code	Description
STATUS_INSUFFICIENT_RESOURCES	L’allocation de la mémoire du pool non paginé nécessaire par cette routine a échoué.
STATUS_INVALID_PARAMETER	L’un des paramètres passés à cette routine n’était pas valide.

Remarques

RxCeBuildConnection doit être appelée dans le contexte d’un thread de travail système.

Lorsque RxCeBuildConnection réussit, les membres de données de la structure RXCE_CONNECTION pointées par le paramètre pConnection et les membres de données de la structure RXCE_VC pointées par le paramètre pVc seront correctement initialisés et le circuit virtuel sera associé à la connexion.

RXCE_CONNECTION_INFORMATION est un typedef pour une structure TDI_CONNECTION_INFORMATION.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	rxce.h (include Rxce.h)
IRQL	<= APC_LEVEL

Voir aussi

RxCearDownConnection

TDI_CONNECTION_INFORMATION

Partager via