NDK_FN_COMPLETE_CONNECT_EX回调函数 (ndkpi.h)
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
要传递回 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 函数完成对 NdkConnect(NDK_FN_CONNECT)函数的调用启动的连接请求。 NDK 使用者在对等方接受连接请求后调用 NdkCompleteConnectEx。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | NDKPI 2.1 及更高版本中受支持。 |
支持的最低服务器 | Windows Server 2022 |
目标平台 | 窗户 |
标头 | ndkpi.h (包括 Ndkpi.h) |
IRQL | <=DISPATCH_LEVEL |