функция обратного вызова 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 Запрос ожидается. Поставщик вызовет функцию NdkRequestCompletion, указанную в параметре RequestCompletion, чтобы завершить запрос асинхронно.
STATUS_CONNECTION_INVALID Сбой запроса, так как пара очередей не подключается. Важные: запрос может завершиться сбоем, а также асинхронно с этим кодом состояния.
STATUS_CONNECTION_ABORTED Принимающие одноранговые узлы отказались от ожидающего создания подключения.
STATUS_IO_TIMEOUT Сбой запроса, так как время ожидания установки подключения истекло. Это не указывает на катастрофический или постоянный сбой, но заканчивается создание подключения для этого соединителя. Важные: запрос может завершиться сбоем, а также асинхронно с этим кодом состояния.
Другие коды состояния Произошла ошибка.

Замечания

Функция NdkCompleteConnectEx завершает запрос подключения, инициированный предыдущим вызовом функции NdkConnect (NDK_FN_CONNECT) . Потребитель NDK вызывает NdkCompleteConnectEx после того, как одноранговый узел принимает запрос на подключение.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Поддерживается в NDKPI 2.1 и более поздних версиях.
минимальный поддерживаемый сервер Windows Server 2022
целевая платформа Виндоус
заголовка ndkpi.h (include 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

  • Last updated on