NDK_FN_COMPLETE_CONNECT回调函数 (ndkpi.h)

项目
08/07/2023

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

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

[in] RequestCompletion

指向请求完成回调 NdkRequestCompletion 函数的指针 (NDK_FN_REQUEST_COMPLETION) 。

[in, optional] RequestContext

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

返回值

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
目标平台	Windows
标头	ndkpi.h (包括 Ndkpi.h)
IRQL	<=DISPATCH_LEVEL