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
一个上下文值，用于传递回 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 |