RxCeBuildTransport-Funktion (rxce.h)
RxCeBuildTransport bindet ein RDBSS-Transportobjekt an einen angegebenen Transportnamen.
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 dem angegebenen Transportnamen zugeordnet, 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 einen der folgenden Fehlercodes bei Einem Fehler zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Bei der Zuordnung des nicht auslagerten Poolspeichers, der für diese Routine benötigt wird, ist ein Fehler aufgetreten. |
|
Einer der parameter, die an diese Routine übergeben wurden, war ungültig. |
Hinweise
Wenn RxCeBuildTransport erfolgreich ist, werden die Datenmember 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 sind nicht an der Berechnung der Dienstqualität beteiligt. RDBSS verwendet im Wesentlichen den QualityOfService-Parameter als magische Zahl, die an den zugrunde liegenden Transportanbieter übergeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | rxce.h (include Rxce.h) |
| IRQL | <= APC_LEVEL |