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

Статья
02/26/2024

Функция 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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Не поддерживается, поддерживается в NDIS 6.30 и более поздних версиях.
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	ndkpi.h (включая Ndkpi.h)
IRQL	<=DISPATCH_LEVEL