PFN_WSK_CONNECT_EX fonction de rappel (wsk.h)
La fonction WskConnectEx connecte un socket orienté connexion ou de flux à une adresse de transport distante.
WskConnectEx est similaire à WskConnect, sauf qu’il peut également envoyer une mémoire tampon de données pendant ou après la synchronisation de la connexion.
Syntaxe
PFN_WSK_CONNECT_EX PfnWskConnectEx;
NTSTATUS PfnWskConnectEx(
[in] PWSK_SOCKET Socket,
[in] PSOCKADDR RemoteAddress,
[in, optional] PWSK_BUF Buffer,
ULONG Flags,
[in, out] PIRP Irp
)
{...}
Paramètres
[in] Socket
Pointeur vers une structure WSK_SOCKET qui spécifie l’objet socket pour le socket connecté à une adresse de transport distante.
[in] RemoteAddress
Pointeur vers une structure qui spécifie l’adresse de transport distante à laquelle connecter le socket. Ce pointeur doit être un pointeur vers le type de structure spécifique SOCKADDR qui correspond à la famille d’adresses spécifiée par l’application WSK spécifiée lors de la création du socket.
[in, optional] Buffer
Pointeur vers une structure WSK_BUF, qui contient les données à envoyer pendant ou après la synchronisation de la connexion. La taille maximale autorisée en octets est de 65 535.
Flags
Ce paramètre est réservé à l’utilisation du système. Une application WSK doit définir ce paramètre sur zéro.
[in, out] Irp
Pointeur vers un IRP alloué par l’appelant que le sous-système WSK utilise pour terminer l’opération de connexion de manière asynchrone. Pour plus d’informations sur l’utilisation d’IRPs avec des fonctions WSK, consultez Utilisation d’IRPs avec winsock Kernel Functions.
Valeur de retour
WskConnectEx retourne l’un des codes NTSTATUS suivants :
| Retourner le code | Description |
|---|---|
|
Le socket a été correctement connecté à l’adresse de transport distante. L’IRP sera terminé avec l’état de réussite. |
|
Le sous-système WSK n’a pas pu connecter le socket immédiatement. Le sous-système WSK termine l’IRP une fois qu’il a connecté le socket à l’adresse de transport distante. L’état de l’opération de connexion est retourné dans le champ IoStatus.Status du protocole IRP. |
|
Le socket n’est plus fonctionnel. L’IRP est terminé avec l’état d’échec. L’application WSK doit appeler la fonction WskCloseSocket pour fermer le socket dès que possible. |
|
L’application WSK a tenté de transmettre un indicateur au paramètre des indicateurs de (car aucun indicateur valide n’est actuellement défini pour WskConnectEx, ce n’est pas autorisé). |
|
L’application WSK a tenté de passer une mémoire tampon supérieure à 65 535 octets au paramètre Tampon. |
|
Une erreur s’est produite. L’IRP est terminé avec l’état d’échec. |
Remarques
Une application WSK peut créer, lier et connecter un socket orienté connexion dans un appel de fonction unique en appelant la fonction WskSocketConnect plutôt que d’appeler la fonction WskSocket, la fonction WskBind, puis la fonction WskConnectEx. Nous vous recommandons d’appeler la fonction WskSocketConnect, sauf si l’application WSK doit définir une option de socket ou émettre une opération de contrôle d’E/S avant la liaison ou la connexion du socket.
Une application WSK peut appeler la fonction WskConnectEx uniquement sur un socket orienté connexion ou de flux que l’application a précédemment liée à une adresse de transport locale en appelant la fonction WskBind.
Pour les sockets de flux, une fois WskConnectEx est appelé avec succès sur un socket de flux, le socket est validé dans un flux orienté connexion et n’appelle plus les fonctions de socket d’écoute.
Si le paramètre tampon est utilisé, l’appelant peut libérer le MDL dans sa structure WSK_BUF dès que la demande de connexion est terminée.
Avant d’appeler WskConnectEx avec une mémoire tampon d’envoi fournie, si l’application WSK définit l’option TCP_FASTOPEN sur un socket WSK via le WskControlSocket fonction, le système envoie éventuellement certaines ou toutes les données dans un paquet SYN. Pour plus d’informations, consultez l’option TCP Fastopen dans IPPROTO_TCP options de socket.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 1703 |
| plateforme cible | Universel |
| d’en-tête | wsk.h (include Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |