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

Artigo
08/07/2023

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 de 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 uma função de retorno de chamada de conclusão de solicitaçã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 .

Retornar valor

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 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 da conexão atingiu o tempo limite. Isso não é uma indicação de uma falha catastrófica ou permanente, mas encerra o estabelecimento da conexão para esse conector. Importante: a solicitação pode falhar embutida, bem como de forma assíncrona com esse código status.
Outros códigos de status	Ocorreu um erro.

Comentários

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
Cliente mínimo com suporte	Com suporte no NDKPI 2.1 e posterior.
Servidor mínimo com suporte	Windows Server 2022
Plataforma de Destino	Windows
Cabeçalho	ndkpi.h (inclua Ndkpi.h)
IRQL	<=DISPATCH_LEVEL