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

Artigo
03/01/2024

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 de conector NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Uma função de retorno de chamada de notificação de desconexão opcional 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 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 especificada 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 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
Cliente mínimo com suporte	Nenhum com suporte, com suporte no NDIS 6.30 e posterior.
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Windows
Cabeçalho	ndkpi.h (inclua Ndkpi.h)
IRQL	<=DISPATCH_LEVEL