NDK_FN_COMPLETE_CONNECT_EX función de devolución de llamada (ndkpi.h)

Artículo
02/07/2025

La función NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) completa una solicitud de conexión asincrónica.

Sintaxis

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
)
{...}

Parámetros

[in] pNdkConnector

Puntero a un objeto de conector NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Un punto de entrada para una función de devolución de llamada de notificación de desconexión opcional NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. El proveedor llama a esta función de devolución de llamada cuando el elemento del mismo nivel se desconecta.

[in, optional] DisconnectEventContext

Valor de contexto que se va a devolver a la función NdkDisconnectEventCallback que se especifica en el parámetro DisconnectEvent de.

[in] RequestCompletion

Puntero a una devolución de llamada de finalización de solicitudes función de NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valor de contexto que el proveedor pasa a la función NdkRequestCompletion. Este valor se especifica en el parámetro requestCompletion de.

Valor devuelto

La función NDK_FN_COMPLETE_CONNECT devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	La solicitud se completó correctamente.
STATUS_PENDING	La solicitud está pendiente. El proveedor llamará a la función NdkRequestCompletion especificada en el parámetro requestCompletion para completar la solicitud de forma asincrónica.
STATUS_CONNECTION_INVALID	Error en la solicitud porque el par de colas no se está conectando. importante: la solicitud puede producir un error en línea, así como de forma asincrónica con este código de estado.
STATUS_CONNECTION_ABORTED	El par aceptado abandonó el establecimiento de conexión pendiente.
STATUS_IO_TIMEOUT	Error en la solicitud porque se agota el tiempo de espera del establecimiento de la conexión. Esto no es una indicación de un error grave o permanente, pero finaliza el establecimiento de la conexión para este conector. importante: la solicitud puede producir un error en línea, así como de forma asincrónica con este código de estado.
otros códigos de estado	Error.

Observaciones

La función NdkCompleteConnectEx completa una solicitud de conexión iniciada por una llamada anterior a la función NdkConnect (NDK_FN_CONNECT). El consumidor de NDK llama a NdkCompleteConnectEx después de que el mismo nivel acepte la solicitud de conexión.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDKPI 2.1 y versiones posteriores.
servidor mínimo admitido	Windows Server 2022
de la plataforma de destino de	Windows
encabezado de	ndkpi.h (incluya Ndkpi.h)
irQL	<=DISPATCH_LEVEL