NDK_FN_COMPLETE_CONNECT_EX回调函数 (ndkpi.h)

项目
02/26/2024

NdkCompleteConnectEx (NDK_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

一个上下文值，用于传递回 DisconnectEvent 参数中指定的 NdkDisconnectEventCallback 函数。

[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 函数完成以前调用 NdkConnect (NDK_FN_CONNECT) 函数发起的连接请求。 NDK 使用者在对等方接受连接请求后调用 NdkCompleteConnectEx 。

要求

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