Fonction RxCeBuildConnection (rxce.h)

Article
03/01/2024

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 à renvoyer au gestionnaire d’événements et à utiliser pour les indications.

[in, out] pConnection

En 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

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

Valeur retournée

RxCeBuildConnection 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 de pool non paginé nécessaire à 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é 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és par le paramètre pConnection et les membres de données de la structure RXCE_VC pointées par le paramètre pVc sont correctement initialisés et le circuit virtuel est associé à la connexion.

RXCE_CONNECTION_INFORMATION est un typedef pour une structure TDI_CONNECTION_INFORMATION .

Configuration requise

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

Voir aussi

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION

Partager via