NDK_FN_COMPLETE_CONNECT_EX Rückruffunktion (ndkpi.h)

Artikel
02/26/2024

Die Funktion NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) schließt eine asynchrone Verbindungsanforderung ab.

Syntax

NDK_FN_COMPLETE_CONNECT_EX NdkFnCompleteConnectEx;

NTSTATUS NdkFnCompleteConnectEx(
  [in]           NDK_CONNECTOR *pNdkConnector,
  [in, optional] NDK_FN_DISCONNECT_EVENT_CALLBACK_EX DisconnectEvent,
  [in, optional] PVOID DisconnectEventContext,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parameter

[in] pNdkConnector

Ein Zeiger auf ein NDK-Connectorobjekt (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Ein Einstiegspunkt für eine optionale Verbindungsbenachrichtigungsrückruffunktion NdkDisconnectEventCallbackEx-Funktion NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. Der Anbieter ruft diese Rückruffunktion auf, wenn der Peer die Verbindung trennt.

[in, optional] DisconnectEventContext

Ein Kontextwert, der an die NdkDisconnectEventCallback-Funktion zurückgegeben werden soll, die im DisconnectEvent-Parameter angegeben ist.

[in] RequestCompletion

Ein Zeiger auf einen Anforderungsabschluss-Rückruf der NdkRequestCompletion-Funktion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Ein Kontextwert, den der Anbieter an die NdkRequestCompletion-Funktion zurückgibt. Dieser Wert wird im Parameter RequestCompletion angegeben.

Rückgabewert

Die funktion NDK_FN_COMPLETE_CONNECT gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Anforderung wurde erfolgreich abgeschlossen.
STATUS_PENDING	Die Anforderung steht aus. Der Anbieter ruft die NdkRequestCompletion-Funktion auf, die im RequestCompletion-Parameter angegeben ist, um die Anforderung asynchron abzuschließen.
STATUS_CONNECTION_INVALID	Die Anforderung ist fehlgeschlagen, weil das Warteschlangenpaar keine Verbindung herstellt. Wichtig: Die Anforderung kann sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
STATUS_CONNECTION_ABORTED	Der akzeptierende Peer hat die ausstehende Verbindungsherstellung abgebrochen.
STATUS_IO_TIMEOUT	Die Anforderung ist fehlgeschlagen, weil für die Verbindungsherstellung ein Timeout aufgetreten ist. Dies ist kein Hinweis auf einen schwerwiegenden oder dauerhaften Ausfall, sondern beendet die Verbindungsherstellung für diesen Connector. Wichtig: Die Anforderung kann sowohl inline als auch asynchron mit diesem status Code fehlschlagen.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Die Funktion NdkCompleteConnectEx schließt eine Verbindungsanforderung ab, die durch einen vorherigen Aufruf der Funktion NdkConnect (NDK_FN_CONNECT) initiiert wurde. Der NDK-Consumer ruft NdkCompleteConnectEx auf, nachdem der Peer die Verbindungsanforderung akzeptiert hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDKPI 2.1 und höher.
Unterstützte Mindestversion (Server)	Windows Server 2022
Zielplattform	Windows
Kopfzeile	ndkpi.h (Ndkpi.h einschließen)
IRQL	<=DISPATCH_LEVEL