RxCeBuildConnection-Funktion (rxce.h)

  • Artikel

RxCeBuildConnection stellt eine Verbindung zwischen einer lokalen RDBSS-Verbindungsadresse und einer angegebenen 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 Adresse der lokalen RDBSS-Verbindungs-Engine.

[in] pConnectionInformation

Ein Zeiger auf die Verbindungsinformationen, der die Remoteadresse angibt.

[in] pHandler

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

[in] pEventContext

Ein Zeiger auf den Kontextparameter, der zurück an den Ereignishandler übergeben und für Hinweise verwendet werden soll.

[in, out] pConnection

Bei der 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 eine nicht initialisierte virtuelle RDBSS-Verbindung. Bei der Ausgabe, wenn dieser Aufruf erfolgreich ist, wird die virtuelle Verbindung der Verbindung zugeordnet, und die virtuelle Verbindung wird ordnungsgemäß initialisiert.

Rückgabewert

RxCeBuildConnection gibt STATUS_SUCCESS bei Erfolg oder einen der folgenden Fehlercodes bei Einem Fehler zurück:

Rückgabecode Beschreibung
STATUS_INSUFFICIENT_RESOURCES
 Fehler bei der Zuordnung des nicht auslagerten Poolspeichers, der für diese Routine benötigt wird.
STATUS_INVALID_PARAMETER
 Einer der an diese Routine übergebenen Parameter war ungültig.

Hinweise

RxCeBuildConnection sollte im Kontext eines Systemworkerthreads aufgerufen werden.

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

RXCE_CONNECTION_INFORMATION ist eine Typdefinition für eine TDI_CONNECTION_INFORMATION-Struktur .

Anforderungen

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

Weitere Informationen

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION