NDK_FN_COMPLETE_CONNECT_EX回调函数 (ndkpi.h)

NdkCompleteConnectExNDK_FN_COMPLETE_CONNECT_EX) 函数完成异步连接请求。

语法

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

参数

[in] pNdkConnector

指向 NDK 连接器对象的指针(NDK_CONNECTOR)。

[in, optional] DisconnectEvent

可选断开连接通知回调函数 NdkDisconnectEventCallbackEx 函数的入口点 NDK_FN_DISCONNECT_EVENT_CALLBACK_EX。 当对等方断开连接时,提供程序将调用此回调函数。

[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 请求失败,因为连接建立超时。这不是灾难性或永久性故障的指示,但它结束了此连接器的连接建立。 重要:请求可以内联失败,也可以异步使用此状态代码。
其他状态代码 发生错误。

言论

NdkCompleteConnectEx 函数完成对 NdkConnectNDK_FN_CONNECT)函数的调用启动的连接请求。 NDK 使用者在对等方接受连接请求后调用 NdkCompleteConnectEx

要求

要求 价值
最低支持的客户端 NDKPI 2.1 及更高版本中受支持。
支持的最低服务器 Windows Server 2022
目标平台 窗户
标头 ndkpi.h (包括 Ndkpi.h)
IRQL <=DISPATCH_LEVEL

另请参阅

NDK_FN_ACCEPT_EX

NDK_FN_DISCONNECT_EVENT_CALLBACK_EX

NDKPI 对象生存期要求

NDK_CONNECTOR

NDK_CONNECTOR_DISPATCH

NDK_FN_CONNECT

NDK_FN_REQUEST_COMPLETION