NDK_FN_COMPLETE_CONNECT funzione di callback (ndkpi.h)

Articolo
02/29/2024

La funzione NdkCompleteConnect (NDK_FN_COMPLETE_CONNECT) completa una richiesta di connessione asincrona.

Sintassi

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

Parametri

[in] pNdkConnector

Puntatore a un oggetto connettore NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Un callback di notifica disconnessione facoltativo NdkDisconnectEventCallback (NDK_FN_DISCONNECT_EVENT_CALLBACK) che il provider chiama 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 specificata 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 NdkCompleteConnect completa una richiesta di connessione avviata da una chiamata precedente alla funzione NdkConnect (NDK_FN_CONNECT). Il consumer NDK chiama NdkCompleteConnect dopo che il peer accetta la richiesta di connessione.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL