NDK_FN_COMPLETE_CONNECT_EX funzione di callback (ndkpi.h)

Articolo
02/07/2025

La funzione NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) completa una richiesta di connessione asincrona.

Sintassi

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

Parametri

[in] pNdkConnector

Puntatore a un oggetto connettore NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Un punto di ingresso per una funzione di callback di notifica disconnessione facoltativa NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. Il provider chiama questa funzione di callback quando il peer si disconnette.

[in, optional] DisconnectEventContext

Valore di contesto da passare nuovamente alla funzione NdkDisconnectEventCallback specificata nel parametro DisconnectEvent.

[in] RequestCompletion

Puntatore a un callback di completamento della richiesta funzione NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valore di contesto restituito dal provider alla funzione NdkRequestCompletion. Questo valore viene specificato nel parametro RequestCompletion.

Valore restituito

La funzione NDK_FN_COMPLETE_CONNECT restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La richiesta è stata completata correttamente.
STATUS_PENDING	La richiesta è in sospeso. Il provider chiamerà la funzione NdkRequestCompletion specificata nel parametro RequestCompletion per completare la richiesta in modo asincrono.
STATUS_CONNECTION_INVALID	La richiesta non è riuscita perché la coppia di code non si connette. importante: la richiesta può non riuscire inline e in modo asincrono con questo codice di stato.
STATUS_CONNECTION_ABORTED	Il peer che accetta ha abbandonato la connessione in sospeso.
STATUS_IO_TIMEOUT	La richiesta non è riuscita perché si è verificato il timeout della connessione. Non si tratta di un'indicazione di un errore irreversibile o permanente, ma termina la definizione della connessione per questo connettore. importante: la richiesta può non riuscire inline e in modo asincrono con questo codice di stato.
Altri codici di stato	Si è verificato un errore.

Osservazioni

La funzione NdkCompleteConnectEx completa una richiesta di connessione avviata da una chiamata precedente alla funzione NdkConnect (NDK_FN_CONNECT). Il consumer NDK chiama NdkCompleteConnectEx dopo che il peer accetta la richiesta di connessione.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato in NDKPI 2.1 e versioni successive.
server minimo supportato	Windows Server 2022
piattaforma di destinazione	Finestre
intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL