функция обратного вызова NDK_FN_COMPLETE_CONNECT_EX (ndkpi.h)

Статья
08/07/2023

Функция 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
Целевая платформа	Windows
Header	ndkpi.h (включая Ndkpi.h)
IRQL	<=DISPATCH_LEVEL