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 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. Cette valeur est 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 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 accepte la demande de connexion.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge dans NDKPI 2.1 et versions ultérieures. |
| serveur minimum pris en charge | Windows Server 2022 |
| plateforme cible | Windows |
| d’en-tête | ndkpi.h (include Ndkpi.h) |
| IRQL | <=DISPATCH_LEVEL |
Voir aussi
NDK_FN_DISCONNECT_EVENT_CALLBACK_EX