NDK_FN_COMPLETE_CONNECT_EX funzione di callback (ndkpi.h)

Articolo
02/29/2024

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

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 alla funzione NdkDisconnectEventCallback specificata nel parametro DisconnectEvent .

[in] RequestCompletion

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

[in, optional] RequestContext

Valore di contesto passato al 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	L'accettazione del peer ha abbandonato l'istituzione di connessione in sospeso.
STATUS_IO_TIMEOUT	La richiesta non è riuscita perché l'istituzione della connessione è stata timeout. Non è un'indicazione di un errore irreversibile o permanente, ma termina l'istituzione 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.

Commenti

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.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in ND KPI 2.1 e versioni successive.
Server minimo supportato	Windows Server 2022
Piattaforma di destinazione	Windows
Intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL