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

Artigo
02/07/2025

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

Sintaxe

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

Parâmetros

[in] pNdkConnector

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

[in, optional] DisconnectEvent

Um retorno de chamada de notificação de desconexão opcional função NdkDisconnectEventCallback(NDK_FN_DISCONNECT_EVENT_CALLBACK) que o provedor chama 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 especificada 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 NdkCompleteConnect 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 NdkCompleteConnect depois que o par aceita a solicitação de conexão.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Nenhum com suporte, com suporte no NDIS 6.30 e posterior.
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Windows
cabeçalho	ndkpi.h (inclua Ndkpi.h)
IRQL	<=DISPATCH_LEVEL