Fonction RxCeBuildTransport (rxce.h)

  • Article

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

En entrée, ce paramètre contient un pointeur vers un transport RDBSS non initialisé auquel ce nom de transport doit être associé. Lors de la 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

La qualité de service souhaitée par le transport.

Valeur retournée

RxCeBuildTransport 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

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

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

Configuration requise

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

Voir aussi

RxCeTearDownTransport