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_DISCONNECT_EVENT_CALLBACK_EX
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour