Partager via


NDK_FN_COMPLETE_CONNECT_EX fonction de rappel (ndkpi.h)

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

Voir aussi

NDK_FN_ACCEPT_EX

NDK_FN_DISCONNECT_EVENT_CALLBACK_EX

Exigences relatives à la durée de vie des objets NDKPI

NDK_CONNECTOR

NDK_CONNECTOR_DISPATCH

NDK_FN_CONNECT

NDK_FN_REQUEST_COMPLETION