RxCeBuildConnection-Funktion (rxce.h)

Artikel
02/07/2025

RxCeBuildConnection stellt eine Verbindung zwischen einer lokalen RDBSS-Verbindungsadresse und einer bestimmten Remoteadresse her.

Syntax

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
);

Parameter

pLocalAddress

Ein Zeiger auf die lokale RDBSS-Verbindungsmoduladresse.

[in] pConnectionInformation

Ein Zeiger auf die Verbindungsinformationen, die die Remoteadresse angibt.

[in] pHandler

Ein Zeiger auf den Ereignishandler für die Verarbeitung von Empfangsanzeigen.

[in] pEventContext

Ein Zeiger auf den Kontextparameter, der an den Ereignishandler übergeben und für Indikationen verwendet wird.

[in, out] pConnection

Bei eingabe enthält dieser Parameter einen Zeiger auf eine nicht initialisierte RDBSS-Verbindung. Bei der Ausgabe, wenn dieser Aufruf erfolgreich ist, wird die Verbindung ordnungsgemäß initialisiert.

[in, out] pVc

Bei der Eingabe enthält dieser Parameter einen Zeiger auf einen nicht initialisierten virtuellen RDBSS-Schaltkreis. Wenn dieser Aufruf erfolgreich ist, wird der virtuelle Schaltkreis der Verbindung zugeordnet, und der virtuelle Schaltkreis wird ordnungsgemäß initialisiert.

Rückgabewert

RxCeBuildConnection- 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

RxCeBuildConnection- sollte im Kontext eines Systemarbeitsthreads aufgerufen werden.

Wenn RxCeBuildConnection- erfolgreich ist, werden die Datenmmber in der RXCE_CONNECTION Struktur, auf die der pConnection-Parameter verweist, und die Datenmber in der RXCE_VC-Struktur, auf die der pVc--Parameter verweist, ordnungsgemäß initialisiert, und der virtuelle Schaltkreis wird der Verbindung zugeordnet.

RXCE_CONNECTION_INFORMATION ist ein Typedef für eine TDI_CONNECTION_INFORMATION-Struktur.

Anforderungen

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

Siehe auch

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION

Freigeben über