NDK_FN_COMPLETE_CONNECT_EX função de retorno de chamada (ndkpi.h)

Artigo
02/07/2025

A função NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) conclui uma solicitação de conexão assíncrona.

Sintaxe

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

Um ponteiro para um objeto do conector NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Um ponto de entrada para uma função de retorno de chamada de notificação de desconexão opcional NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. O provedor chama essa função de retorno de chamada quando o par se desconecta.

[in, optional] DisconnectEventContext

Um valor de contexto a ser passado de volta para a função NdkDisconnectEventCallback especificada no parâmetro DisconnectEvent.

[in] RequestCompletion

Um ponteiro para um retorno de chamada de conclusão de solicitação função NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Um valor de contexto que o provedor passa de volta para a função NdkRequestCompletion. Esse valor é especificado no parâmetro RequestCompletion.

Valor de retorno

A função NDK_FN_COMPLETE_CONNECT retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	A solicitação foi concluída com êxito.
STATUS_PENDING	A solicitação está pendente. O provedor chamará a função NdkRequestCompletion especificada no parâmetro RequestCompletion para concluir a solicitação de forma assíncrona.
STATUS_CONNECTION_INVALID	A solicitação falhou porque o par de filas não está se conectando. Importante: a solicitação pode falhar embutida, bem como de forma assíncrona com esse código de status.
STATUS_CONNECTION_ABORTED	O par de aceitação abandonou o estabelecimento de conexão pendente.
STATUS_IO_TIMEOUT	A solicitação falhou porque o estabelecimento de conexão atingiu o tempo limite. Isso não é uma indicação de uma falha catastrófica ou permanente, mas encerra o estabelecimento de conexão para esse conector. Importante: a solicitação pode falhar embutida, bem como de forma assíncrona com esse código de status.
Outros códigos de status	Ocorreu um erro.

Observações

A função NdkCompleteConnectEx conclui uma solicitação de conexão iniciada por uma chamada anterior para a função NdkConnect (NDK_FN_CONNECT). O consumidor do NDK chama NdkCompleteConnectEx depois que o par aceita a solicitação de conexão.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDKPI 2.1 e posterior.
servidor com suporte mínimo	Windows Server 2022
da Plataforma de Destino	Windows
cabeçalho	ndkpi.h (inclua Ndkpi.h)
IRQL	<=DISPATCH_LEVEL