Freigeben über


NDK_FN_COMPLETE_CONNECT Rückruffunktion (ndkpi.h)

Die Funktion NdkCompleteConnect (NDK_FN_COMPLETE_CONNECT) führt eine asynchrone Verbindungsanforderung aus.

Syntax

NDK_FN_COMPLETE_CONNECT NdkFnCompleteConnect;

NTSTATUS NdkFnCompleteConnect(
  [in]           NDK_CONNECTOR *pNdkConnector,
  [in, optional] NDK_FN_DISCONNECT_EVENT_CALLBACK 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 optionaler Verbindungsbenachrichtigungsrückruf NdkDisconnectEventCallback-Funktion (NDK_FN_DISCONNECT_EVENT_CALLBACK), den der Anbieter aufruft, 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, die im RequestCompletion-Parameter angegeben ist.

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 NdkCompleteConnect-Funktion schließt eine Verbindungsanforderung ab, die durch einen vorherigen Aufruf der Funktion NdkConnect (NDK_FN_CONNECT) initiiert wurde. Der NDK-Consumer ruft NdkCompleteConnect auf, nachdem der Peer die Verbindungsanforderung akzeptiert hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Keine unterstützt, unterstützt in NDIS 6.30 und höher.
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile ndkpi.h (Ndkpi.h einschließen)
IRQL <=DISPATCH_LEVEL

Weitere Informationen

Anforderungen an die Lebensdauer des NDKPI-Objekts

NDK_CONNECTOR

NDK_CONNECTOR_DISPATCH

NDK_FN_CONNECT

NDK_FN_DISCONNECT_EVENT_CALLBACK

NDK_FN_REQUEST_COMPLETION