Partager via


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é à l’appelant que le sous-système WSK utilise pour effectuer l’opération d’écoute de manière asynchrone. Pour plus d’informations sur l’utilisation des irps avec des fonctions WSK, consultez Utilisation des irps avec les fonctions du noyau Winsock.

Valeur retournée

WskListen retourne l’un des codes NTSTATUS suivants :

Code de retour Description
STATUS_SUCCESS
Le socket de flux a écouté une connexion entrante avec succès. Le IRP sera terminé avec succès status.
STATUS_PENDING
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.
STATUS_FILE_FORCED_CLOSED
Le socket n’est plus fonctionnel. L’IRP sera terminé avec l’échec status. L’application WSK doit appeler la fonction WskCloseSocket pour fermer le socket dès que possible.
Autres codes status
Une erreur est survenue. L’IRP sera terminé avec l’échec status.

Remarques

Une application WSK peut appeler la fonction WskListen uniquement sur un socket de flux que l’application a précédemment lié à une adresse de transport locale en appelant la fonction WskBind . Une fois que WskListen a été appelé avec succès sur un socket de flux, le socket est engagé dans un flux de socket d’écoute et ne peut plus appeler des fonctions de socket orientées connexion.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 version 1703
Plateforme cible Universal
En-tête wsk.h (inclure Wsk.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskAccept

WskBind

WskCloseSocket