NDK_FN_COMPLETE_CONNECT fonction de rappel (ndkpi.h)

Article
02/07/2025

La fonction NdkCompleteConnect (NDK_FN_COMPLETE_CONNECT) termine une demande de connexion asynchrone.

Syntaxe

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

Paramètres

[in] pNdkConnector

Pointeur vers un objet connecteur NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Rappel de notification de déconnexion facultatif NdkDisconnectEventCallback function(NDK_FN_DISCONNECT_EVENT_CALLBACK) que le fournisseur appelle lorsque l’homologue se déconnecte.

[in, optional] DisconnectEventContext

Valeur de contexte à transmettre à la fonction NdkDisconnectEventCallback spécifiée dans le paramètre DisconnectEvent.

[in] RequestCompletion

Pointeur vers un rappel de saisie semi-automatique de requête NdkRequestCompletion function (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valeur de contexte que le fournisseur transmet à la fonction NdkRequestCompletion spécifiée dans le paramètre RequestCompletion.

Valeur de retour

La fonction NDK_FN_COMPLETE_CONNECT retourne l’un des codes NTSTATUS suivants.

Retourner le code	Description
STATUS_SUCCESS	La demande a été effectuée avec succès.
STATUS_PENDING	La demande est en attente. Le fournisseur appelle la fonction NdkRequestCompletion spécifiée dans le paramètre RequestCompletion pour terminer la requête de manière asynchrone.
STATUS_CONNECTION_INVALID	La requête a échoué, car la paire de files d’attente ne se connecte pas. Important La requête peut échouer en ligne, ainsi que de manière asynchrone avec ce code d’état.
STATUS_CONNECTION_ABORTED	L’homologue accepté a abandonné l’établissement de connexion en attente.
STATUS_IO_TIMEOUT	La demande a échoué, car l’établissement de la connexion a expiré. Ce n’est pas une indication d’une défaillance catastrophique ou permanente, mais il met fin à l’établissement de la connexion pour ce connecteur. Important La requête peut échouer en ligne, ainsi que de manière asynchrone avec ce code d’état.
Autres codes d’état	Une erreur s’est produite.

Remarques

La fonction NdkCompleteConnect termine une demande de connexion lancée par un appel précédent à la fonction NdkConnect (NDK_FN_CONNECT). Le consommateur NDK appelle NdkCompleteConnect une fois que l’homologue accepte la demande de connexion.

Exigences

Exigence	Valeur
client minimum pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Windows
d’en-tête	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL