NDK_FN_COMPLETE_CONNECT_EX Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) -Funktion 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-Verbinderobjekt (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Ein Einstiegspunkt für eine optionale Disconnect-Benachrichtigungsrü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 übergeben werden soll, die im parameter DisconnectEvent angegeben ist.

[in] RequestCompletion

Ein Zeiger auf einen Anforderungsabschlussrückruf 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 NDK_FN_COMPLETE_CONNECT-Funktion 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 parameter RequestCompletion angegeben ist, um die Anforderung asynchron abzuschließen.
STATUS_CONNECTION_INVALID	Fehler bei der Anforderung, da das Warteschlangenpaar keine Verbindung herstellt. Wichtige: Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
STATUS_CONNECTION_ABORTED	Der akzeptierte Peer hat die ausstehende Verbindungseinrichtung abgebrochen.
STATUS_IO_TIMEOUT	Fehler bei der Anforderung, da die Verbindungseinrichtung ein Timeout ausgeführt hat. Dies ist kein Hinweis auf einen katastrophalen oder dauerhaften Ausfall, aber es endet die Verbindungseinrichtung für diesen Verbinder. Wichtige: Die Anforderung kann inline und asynchron mit diesem Statuscode fehlschlagen.
Andere Statuscodes	Fehler.

Bemerkungen

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDKPI 2.1 und höher.
mindestens unterstützte Server-	Windows Server 2022
Zielplattform-	Fenster
Header-	ndkpi.h (include Ndkpi.h)
IRQL-	<=DISPATCH_LEVEL