NDK_FN_COMPLETE_CONNECT回调函数（ndkpi.h）

项目
02/07/2025

NdkCompleteConnect （NDK_FN_COMPLETE_CONNECT）函数完成异步连接请求。

语法

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
)
{...}

参数

[in] pNdkConnector

指向 NDK 连接器对象的指针（NDK_CONNECTOR）。

[in, optional] DisconnectEvent

一个可选的断开连接通知回调 NdkDisconnectEventCallback 函数（NDK_FN_DISCONNECT_EVENT_CALLBACK），提供程序在对等断开连接时调用。

[in, optional] DisconnectEventContext

要传递回 NdkDisconnectEventCallback 函数的上下文值，该函数是在 DisconnectEvent 参数中指定的。

[in] RequestCompletion

指向请求完成回调的指针，NdkRequestCompletion 函数（NDK_FN_REQUEST_COMPLETION）。

[in, optional] RequestContext

提供程序将传递回 NdkRequestCompletion 函数的上下文值，该函数是在 RequestCompletion 参数中指定的。

返回值

NDK_FN_COMPLETE_CONNECT 函数返回以下 NTSTATUS 代码之一。

返回代码	描述
STATUS_SUCCESS	请求已成功完成。
STATUS_PENDING	请求挂起。提供程序将调用在 RequestCompletion 参数中指定的 NdkRequestCompletion 函数，以异步完成请求。
STATUS_CONNECTION_INVALID	请求失败，因为队列对未连接。重要请求可以内联失败，以及使用此状态代码异步失败。
STATUS_CONNECTION_ABORTED	接受的对等方放弃了挂起的连接建立。
STATUS_IO_TIMEOUT	请求失败，因为连接建立超时。这不是灾难性或永久性故障的指示，但它结束了此连接器的连接建立。重要请求可以内联失败，以及使用此状态代码异步失败。
其他状态代码	发生错误。

言论

NdkCompleteConnect 函数完成对 NdkConnect（NDK_FN_CONNECT）函数的上一次调用发起的连接请求。 NDK 使用者在对等方接受连接请求后调用 NdkCompleteConnect。

要求

要求	价值
最低支持的客户端	NDIS 6.30 及更高版本不支持。
支持的最低服务器	Windows Server 2012
目标平台	窗户
标头	ndkpi.h （包括 Ndkpi.h）
IRQL	<=DISPATCH_LEVEL