PFN_WSK_LISTEN fonction de rappel (wsk.h)
La fonction WskListen permet à un socket de flux d’écouter les connexions entrantes à l’adresse liée du socket.
Syntaxe
PFN_WSK_LISTEN PfnWskListen;
NTSTATUS PfnWskListen(
[in] PWSK_SOCKET Socket,
[in, out] PIRP Irp
)
{...}
Paramètres
[in] Socket
Pointeur vers une structure WSK_SOCKET qui spécifie l’objet socket pour le socket de flux qui écoute une connexion entrante. Ce socket doit avoir été précédemment lié à une adresse de transport locale en appelant WskBind.
[in, out] Irp
Pointeur vers un IRP alloué par l’appelant que le sous-système WSK utilise pour terminer l’opération d’écoute 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
WskListen retourne l’un des codes NTSTATUS suivants :
| Retourner le code | Description |
|---|---|
|
Le socket de flux a écouté une connexion entrante avec succès. L’IRP sera terminé avec l’état de réussite. |
|
L’IRP a été mis en file d’attente par le sous-système WSK, qui attend une connexion entrante sur le socket de flux. |
|
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. |
|
Une erreur s’est produite. L’IRP est terminé avec l’état d’échec. |
Remarques
Une application WSK peut appeler la fonction WskListen uniquement sur un socket de flux que l’application était précédemment liée à une adresse de transport locale en appelant la fonction WskBind. Une fois WskListen est appelé avec succès sur un socket de flux, le socket est validé dans un flux de socket d’écoute et ne peut plus appeler les fonctions de socket orientée connexion.
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 |