RxCeBuildTransport-Funktion (rxce.h)

RxCeBuildTransport ein RDBSS-Transportobjekt an einen angegebenen Transportnamen bindet.

Syntax

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

Parameter

pRxCeTransport

Bei der Eingabe enthält dieser Parameter einen Zeiger auf einen nicht initialisierten RDBSS-Transport, dem dieser Transportname zugeordnet werden soll. Bei der Ausgabe, wenn dieser Aufruf erfolgreich ist, wird der Transport mit dem angegebenen Transportnamen verknüpft, und der Transport wird ordnungsgemäß initialisiert.

[in] pTransportName

Ein Zeiger auf die Unicode-Bindungszeichenfolge für den gewünschten Transport.

[in] QualityOfService

Die vom Transport gewünschte Servicequalität.

Rückgabewert

RxCeBuildTransport- gibt STATUS_SUCCESS bei Erfolg oder einer der folgenden Fehlercodes für Fehler zurück:

Rückgabecode Beschreibung
STATUS_INSUFFICIENT_RESOURCES
Fehler bei der Zuordnung des nicht ausseitigen Poolspeichers, der von dieser Routine benötigt wird.
STATUS_INVALID_PARAMETER
Einer der Parameter, die an diese Routine übergeben wurden, war ungültig.

Bemerkungen

Wenn RxCeBuildTransport erfolgreich ist, werden die Datenmmber in der RXCE_TRANSPORT Struktur, auf die der pTransport Parameter verweist, ordnungsgemäß initialisiert, und der RDBSS-Transport wird an den angegebenen TDI-Transport gebunden.

Die Verbindungsmodulroutinen in RDBSS nehmen nicht an der Berechnung der Dienstqualität teil. RDBSS verwendet im Wesentlichen den QualityOfService Parameter als magische Zahl, die an den zugrunde liegenden Transportanbieter übergeben wird.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- rxce.h (include Rxce.h)
IRQL- <= APC_LEVEL

Siehe auch

RxCeTearDownTransport