NDK_FN_COMPLETE_CONNECT_EX fonction de rappel (ndkpi.h)

Article
02/26/2024

La fonction NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) termine une demande de connexion asynchrone.

Syntaxe

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

Paramètres

[in] pNdkConnector

Pointeur vers un objet connecteur NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Point d’entrée pour une fonction de rappel de notification de déconnexion facultative NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. Le fournisseur appelle cette fonction de rappel 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 de rappel de fin de requête (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Valeur de contexte que le fournisseur transmet à la fonction NdkRequestCompletion . Cette valeur est 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 effectuer 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 demande peut échouer en ligne et de manière asynchrone avec ce code status.
STATUS_CONNECTION_ABORTED	L’homologue acceptant a abandonné l’établissement de 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 demande peut échouer en ligne et de manière asynchrone avec ce code status.
Autres codes status	Une erreur est survenue.

Remarques

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDKPI 2.1 et versions ultérieures.
Serveur minimal pris en charge	Windows Server 2022
Plateforme cible	Windows
En-tête	ndkpi.h (inclure Ndkpi.h)
IRQL	<=DISPATCH_LEVEL