NDK_FN_COMPLETE_CONNECT fonction de rappel (ndkpi.h)

Article
03/05/2024

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 une fonction NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) de rappel de fin de requête.

[in, optional] RequestContext

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

Valeur retournée

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

Code de retour	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 demande a échoué, car la paire de file d’attente ne se connecte pas. Important La requête peut échouer en ligne et de manière asynchrone avec ce code status.
STATUS_CONNECTION_ABORTED	L’homologue acceptant a abandonné l’établissement de la connexion en attente.
STATUS_IO_TIMEOUT	La demande a échoué, car l’établissement de la connexion a expiré. Il ne s’agit pas d’une indication d’une défaillance catastrophique ou permanente, mais elle met fin à l’établissement de la connexion pour ce connecteur. Important La requête peut échouer en ligne et de manière asynchrone avec ce code status.
Autres codes status	Une erreur est survenue.

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 après que l’homologue a accepté la demande de connexion.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucune prise en charge, prise en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	ndkpi.h (incluez Ndkpi.h)
IRQL	<=DISPATCH_LEVEL