RxCeBuildAddress-Funktion (rxce.h)

Artikel
02/29/2024

RxCeBuildAddress ordnet eine Transportadresse einer Transportbindung zu.

Syntax

NTSTATUS RxCeBuildAddress(
  [in, out] IN OUT PRXCE_ADDRESS           pAddress,
  [in]      IN PRXCE_TRANSPORT             pTransport,
  [in]      IN PTRANSPORT_ADDRESS          pTransportAddress,
  [in]      IN PRXCE_ADDRESS_EVENT_HANDLER pHandler,
  [in]      IN PVOID                       pEventContext
);

Parameter

[in, out] pAddress

Bei der Eingabe enthält dieser Parameter einen Zeiger auf eine nicht initialisierte RDBSS-Verbindungs-Engine-Adressstruktur. Bei der Ausgabe, wenn dieser Aufruf erfolgreich ist, werden die Datenmember in der RXCE_ADDRESS-Struktur ordnungsgemäß initialisiert.

[in] pTransport

Ein Zeiger auf den Transport, dem diese Adresse zugeordnet werden soll.

[in] pTransportAddress

Ein Zeiger auf die Transportadresse, die der Bindung zugeordnet werden soll.

[in] pHandler

Ein Zeiger auf den Ereignishandler, der der Registrierung zugeordnet ist.

[in] pEventContext

Ein Zeiger auf den Kontextparameter, der an den Ereignishandler zurückgegeben werden soll.

Rückgabewert

RxCeBuildAddress 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 RxCeBuildAddress übergebenen Parameter war ungültig.

Hinweise

Wenn RxCeBuildAddress erfolgreich ist, werden die Datenmember in der RXCE_ADDRESS Struktur, auf die der pAddress-Parameter verweist, ordnungsgemäß initialisiert.

Anforderungen

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

Weitere Informationen

RxCeTearDownAddress

Freigeben über