Compartilhar via


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

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

Confira também

Requisitos de tempo de vida do objeto NDKPI

NDK_CONNECTOR

NDK_CONNECTOR_DISPATCH

NDK_FN_CONNECT

NDK_FN_DISCONNECT_EVENT_CALLBACK

NDK_FN_REQUEST_COMPLETION