RxCeBuildTransport, fonction (rxce.h)

Article
02/07/2025

RxCeBuildTransport lie un objet de transport RDBSS à un nom de transport spécifié.

Syntaxe

NTSTATUS RxCeBuildTransport(
       IN PRXCE_TRANSPORT pRxCeTransport,
  [in] IN PUNICODE_STRING pTransportName,
  [in] IN ULONG           QualityOfService
);

Paramètres

pRxCeTransport

Lors de l’entrée, ce paramètre contient un pointeur vers un transport RDBSS non initialisé avec lequel ce nom de transport doit être associé. En sortie lorsque cet appel réussit, le transport est associé au nom de transport spécifié et le transport est correctement initialisé.

[in] pTransportName

Pointeur vers la chaîne de liaison Unicode pour le transport souhaité.

[in] QualityOfService

Qualité de service souhaitée par le transport.

Valeur de retour

RxCeBuildTransport 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

Lorsque RxCeBuildTransport réussit, les membres de données de la structure RXCE_TRANSPORT pointées par le paramètre pTransport seront correctement initialisés et le transport RDBSS sera lié au transport TDI spécifié.

Les routines du moteur de connexion dans RDBSS ne participent pas au calcul de la qualité du service. RDBSS utilise essentiellement le paramètre QualityOfService en tant que nombre magique transmis au fournisseur de transport sous-jacent.

Exigences

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

Voir aussi

RxCearDownTransport

Partager via